Động lực và giới thiệu  Xem trước bản dựng không có gì mới hoặc sáng tạo. Heroku đã có chúng trong nhiều năm. Tuy nhiên, nếu bạn đang xây dựng trên Google Cloud Platform, mọi thứ sẽ khó khăn hơn một chút. Google Cloud Build có thể được sử dụng để triển khai cho Cloud Function, Cloud Run, Kubernetes, App Engine, v.v. Đây là điều khiến cho việc xem trước hơi phức tạp vì Cloud Build không biết bạn đang triển khai ứng dụng hoặc dịch vụ của mình đến đâu. Họ có Ứng dụng GitHub để kết nối các kho lưu trữ và hiển thị trạng thái bản dựng trong GitHub, nhưng chỉ có vậy. Không có bản xem trước, nhận xét hoặc bất kỳ nội dung "bình thường" nào mà chúng tôi quen dùng từ các sản phẩm như Heroku, Vercel hoặc Fly.  Có một cách "dễ dàng" để đăng nhận xét về Yêu cầu kéo GitHub từ Cloud Build bằng một yêu cầu HTTP đơn giản. Nhưng tại sao lại dễ dàng khi bạn có thể sử dụng   . API triển khai GitHub  Với API này, bạn có thể tạo Môi trường, có các biến khác nhau cho mỗi môi trường và hiển thị trạng thái xây dựng & triển khai trực tiếp trên Yêu cầu kéo. Và sau khi quá trình triển khai hoàn tất trên nền tảng CD của bạn, bạn có thể thêm URL vào trạng thái triển khai. Đây là những gì chúng ta sẽ làm trong bài viết này.   Trạng thái triển khai GitHub  Một lần nữa, có một cách khác để thực hiện việc này bằng cách sử dụng API Triển khai trực tiếp với các yêu cầu HTTP. Tuy nhiên, điều này đôi khi có thể phức tạp và bạn sẽ cần xác định Mã thông báo truy cập cá nhân để xác thực với GitHub. Thay vào đó, chúng tôi quyết định kết hợp một dịch vụ Node.js nhỏ sử dụng Ứng dụng GitHub để tạo mã thông báo ứng dụng và tương tác với API triển khai. Điều này cho phép kiểm soát tốt hơn một chút đối với quá trình triển khai.  từ chối trách nhiệm  Bài viết này được viết riêng cho Google Cloud Platform và GitHub. Giả sử hiểu biết cơ bản về Google Cloud Platform, Google Cloud Build và các quyền IAM.  Bạn nên thiết lập dự án Google Cloud Platform.  Trình triển khai GitHub (Node.js & Docker)  GitHub Deployer là một dịch vụ Node.js nhỏ được ủy quyền với Ứng dụng GitHub và tương tác với API Triển khai GitHub. Các lệnh được xác định trước và một số thông tin cần được tích hợp vào hình ảnh Docker, nếu không, cấu hình thời gian chạy trong Cloud Build sẽ trở nên quá phức tạp.  Hình ảnh Docker chưa sẵn sàng được xây dựng; bạn sẽ cần tự xây dựng nó và đẩy nó vào sổ đăng ký của mình. Nơi tốt nhất là Google Artifact Registry nơi cũng lưu trữ hình ảnh cho ứng dụng của bạn (Container Registry không được dùng nữa):  Nếu chưa hoàn thành, hãy tạo một kho lưu trữ Artifact Registry  Tạo Ứng dụng GitHub và cài đặt nó trên tổ chức của bạn   Tạo ứng dụng GitHub  Quyền cần thiết: 'pull_requests', 'triển khai', 'siêu dữ liệu'  Sao chép ID ứng dụng (từ màn hình Cài đặt ứng dụng) và ID cài đặt ứng dụng (sau khi nhấp vào "Định cấu hình", bạn sẽ tìm thấy ID cài đặt trong URL. Không biết có thể tìm thấy ở đâu khác)  Tạo và tải xuống khóa riêng tư và chuyển đổi nó thành base64 (   )  base64 -i your.private-key.pem  Xây dựng hình ảnh Docker   Nguồn  Cloud Build chạy trên   , vì vậy chúng tôi cần   để xây dựng hình ảnh cho nền tảng x86: amd64 buildx   docker buildx build --platform linux/amd64 . -t us-central1-docker.pkg.dev/[PROJECT]/docker/gh-deployer \   --build-arg GH_APP_ID=[GITHUB_APP_ID] \   --build-arg GH_APP_PRIVATE_KEY=[GITHUB_PRIVATE_KEY_BASE_64] \   --build-arg GH_APP_INSTALLATION_ID=[GITHUB_INSTALLATION_ID] \   --build-arg GH_OWNER=[GITHUB_ORG]  Đẩy hình ảnh vào sổ đăng ký của bạn:   docker push us-central1-docker.pkg.dev/[PROJECT]/docker/gh-deployer  Chạy hình ảnh Docker cục bộ   docker run -it -e REPO_NAME=test -e REF=main -e ENVIRONMENT=test us-central1-docker.pkg.dev/[PROJECT]/docker/gh-deployer:latest create  Các biến môi trường bắt buộc:    :   tên của kho lưu trữ (ví dụ:   ) REPO_NAME yêu cầu gh-deployer    :   nhánh, thẻ hoặc SHA triển khai (ví dụ:   ) REF yêu cầu main    :   môi trường để triển khai (ví dụ:   ) ENVIRONMENT yêu cầu preview    :   nếu được đặt thành   , việc triển khai sẽ bị xóa sau một thời gian nhất định TRANSIENT_ENVIRONMENT tùy chọn/false true    :   một mô tả của việc triển khai DESCRIPTION tùy chọn  Các lệnh sau có sẵn dưới dạng đối số đầu tiên:    - tạo một triển khai mới create    - bản dựng đang chờ xử lý pending    - quá trình xây dựng đang được tiến hành in_progress    - bản dựng được xếp hàng đợi queued    - việc triển khai đã thành công success    - đã xảy ra sự cố error    - việc triển khai thất bại failure  Với Cloud Build, các tùy chọn hiện có một chút hạn chế. Không có trạng thái   vì Cloud Build cần bắt đầu để tạo triển khai ban đầu.   cũng không có nhiều ý nghĩa, vì vậy trong thiết lập của riêng chúng tôi, chúng tôi đang sử dụng như sau: pending queued    để tạo triển khai tạm thời cho một cam kết gh-deployer/create    trực tiếp sau khi tạo pgh-deployer/ending  Chạy bản dựng kaniko để xây dựng hình ảnh Docker để triển khai    sau khi quá trình xây dựng hoàn tất và trước khi hình ảnh được triển khai gh-deployer/in_progress    sau khi hình ảnh được triển khai gh-deployer/success  Một lần nữa, với Cloud Build, chúng tôi không biết nơi triển khai sẽ diễn ra, vì vậy, có hai cách để chuyển URL triển khai đến bước   : success  Trong bước xây dựng, hãy ghi URL vào  /workspace/deployer_environment_url  Truyền đối số thứ hai cho hình ảnh Docker sau khi  success  Chúng tôi sử dụng Cloud Run cho các triển khai của mình, vì vậy, đây là bước xây dựng để truy xuất URL triển khai cho một số Yêu cầu kéo nhất định:  - tên: gcr.io/google.com/cloudsdktool/cloud-sdk   env: - PR_NUMBER=$_PR_NUMBER script: >- gcloud run services list --project [project] --filter preview-$PR_NUMBER --format "value(status.address.url)" > /workspace/deployer_environment_url  Cấu hình xây dựng đám mây/Terraform  đám mâybuild.yaml   đám mâybuild.yaml  Đây là một ví dụ hoàn chỉnh sử dụng tệp cấu hình   . Chúng tôi sử dụng Kaniko để xây dựng và Cloud Run làm mục tiêu triển khai. cloudbuild.yaml  Nếu bạn làm việc với Terraform, thì cũng có một tệp Terraform:  preview.tf  Hành động GitHub  Bằng cách sử dụng Deployments API, bạn có thể kích hoạt GitHub Actions trên   . Điều này giúp dễ dàng chạy kiểm tra đảm bảo chất lượng, kiểm tra từ đầu đến cuối, v.v. trên mỗi bản dựng xem trước. Dưới đây là ví dụ về cách chạy   trên mỗi bản xem trước bằng cách sử dụng   được chuyển vào trạng thái   : deployment_status Playwright environment_url success  nhà viết kịch-qa:   if: ${{ github.event.deployment\_status.state == 'success' }} timeout-minutes: 60 runs-on: ubuntu\-latest steps: \- uses: actions/[\[email protected\]](/cdn-cgi/l/email-protection) \- uses: actions/setup\-[\[email protected\]](/cdn-cgi/l/email-protection) with: node-version: 20 cache: 'npm' \- run: npm ci \- name: Install Playwright Browsers run: npm exec playwright install \-\-with\-deps \-y \- name: Run Playwright tests run: pnpm exec playwright test env: BASE\_URL: ${{github.event.deployment\_status.environment\_url}} \- uses: actions/upload\-[\[email protected\]](/cdn-cgi/l/email-protection) if: always() with: name: playwright\-report path: playwright\-report/ retention-days: 30  tối ưu hóa  hình ảnh cơ bản   tương đối lớn. Bạn có thể   để tăng tốc độ xây dựng. gcr.io/google.com/cloudsdktool/cloud-sdk xây dựng hình ảnh gcloud nhỏ của riêng mình bằng các thành phần Cloud Run  Phần kết luận   Trạng thái triển khai GitHub Đã xong  Nhận xét về Yêu cầu kéo GitHub lúc đầu rất dễ dàng, nhưng khi bạn có nhiều triển khai cho mỗi Yêu cầu kéo, các bản dựng không thành công, v.v. thì chúng không mang lại nhiều tính linh hoạt và khó bảo trì/cập nhật. API Triển khai GitHub cung cấp một cách tinh tế để tạo và quản lý các triển khai từ bất kỳ hệ thống CI/CD bên thứ ba nào. Với   , chúng tôi đã cố gắng hợp lý hóa sự tương tác với API triển khai và xử lý một số tác dụng phụ hoặc cạm bẫy không thể giải quyết chỉ bằng API HTTP. GitHub Deployer  Một lợi ích khác của việc sử dụng API triển khai GitHub là bạn có thể sử dụng trình kích hoạt   cho các Tác vụ GitHub và nhận trực tiếp   với tải trọng sự kiện. deployment_status environment_url  Bạn có thể tìm thấy hướng dẫn cài đặt/xây dựng chi tiết hơn một chút và tất cả mã trên  kho lưu trữ GitHub    , vui lòng   /   hoặc   . Nếu bạn có bất kỳ câu hỏi hoặc nhận xét nào liên hệ trên BlueSky Twitter tham gia thảo luận trên GitHub  Cũng được xuất bản  ở đây.

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Read My Stories

Problem Solver at Zentered

Nghe bài viết này bằng Tiếng Anh, đọc bởi robot thông minh của HackerNoon

Triển khai GitHub (Bản xem trước) với Google Cloud Platform: Hướng dẫn cần thiết

About Author

BÌNH LUẬN

chuyên mục

BÀI VIẾT NÀY CŨNG CÓ MẶT TẠI

Related Stories

94 Stories To Learn About John Locke

128 Stories To Learn About Charles Dickens

72 Stories To Learn About The Essays Of Adam Smith

240 Stories To Learn About Astounding Stories

94 Stories To Learn About John Locke

128 Stories To Learn About Charles Dickens

72 Stories To Learn About The Essays Of Adam Smith

240 Stories To Learn About Astounding Stories

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps