部署到 Google Kubernetes Engine

注： GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。您可以在 GitHub 公共路线图上查看有关未来支持计划的更多信息。

简介

本指南介绍如何使用 GitHub Actions 构建容器化应用程序，将其推送到 Google Container Registry (GCR)，以及要推送到 main 分支时将其部署到 Google Kubernetes Engine (GKE)。

GKE 是 Google Cloud 的托管 Kubernetes 群集服务，可以在云中或您自己的数据中心中托管您的容器化工作负载。更多信息请参阅 Google Kubernetes Engine。

基本要求

在继续创建工作流程之前，您需要完成 Kubernetes 项目的以下步骤。本指南假定项目的� �目录已有 Dockerfile 和 Kubernetes 部署配置文件。例如，请参阅 google-github-。

创建 GKE 群集

要创建 GKE 群集，首先需要使用 gcloud CLI 进行身份验证。有关此步骤的更多信息，请参阅以下文� ：

例如：

Shell

$ gcloud container clusters create $GKE_CLUSTER \
    --project=$GKE_PROJECT \
    --zone=$GKE_ZONE

启用 API

启用 Kubernetes Engine 和 Container Registry API。例如：

Shell

$ gcloud services enable \
    containerregistry.googleapis.com \
    container.googleapis.com

配置服务帐户并存储其凭据

此程序显示如何为您的 GKE 集成创建服务帐户。它说明了如何创建帐户、向其添� 角色、检索其密钥，以及将它们存储为名为 GKE_SA_KEY 的� 密仓库机密。

创建新服务帐户：

$ gcloud iam service-accounts create $SA_NAME

检索您刚刚创建的服务帐户的电子邮件地址：
```
$ gcloud iam service-accounts list
```

向服务帐户添� 角色。注意：应用限制更严� �的角色以满足您的要求。

$ gcloud projects add-iam-policy-binding $GKE_PROJECT \
  --member=serviceAccount:$SA_EMAIL \
  --role=roles/container.admin
$ gcloud projects add-iam-policy-binding $GKE_PROJECT \
  --member=serviceAccount:$SA_EMAIL \
  --role=roles/storage.admin
$ gcloud projects add-iam-policy-binding $GKE_PROJECT \
  --member=serviceAccount:$SA_EMAIL \
  --role=roles/container.clusterViewer

下载服务帐户的 JSON 密钥文件：

$ gcloud iam service-accounts keys create key.json --iam-account=$SA_EMAIL

将服务帐户密钥存储为名为 GKE_SA_KEY 的机密：
```
$ export GKE_SA_KEY=$(cat key.json | base64)
```
有关如何存储机密的更多信息，请参阅“� 密密� �”。

存储项目名称

将项目名称存储为名为 GKE_PROJECT 的机密。有关如何存储机密的更多信息，请参阅“� 密密� �”。

（可选）配置 kustomize

Kustomize 是用于管理 YAML 规范的可选工具。在创建 kustomization 文件之后，下面的工作流可用于将结果中的图像和管道字段动态设置为 kubectl。更多信息请参阅 kustomize 的用法。

（可选）配置部署环境

环境用于描述一般的部署目� �，如生产、暂存或开发。当 GitHub Actions 工作流程部署到某个环境时，该环境将显示在存储库的主页上。您可以使用环境来要求批准才能继续作业，限制哪些分支可以触发工作流程，或限制对机密的访问。有关创建环境的更多信息，请参阅“使用环境进行部署”。

创建工作流程

完成先决条件后，可以继续创建工作流程。

下面的示例工作流程演示如何生成容器� 像并推送到 GCR。然后，它使用 Kubernetes 工具（如 kubectl 和 kustomize）将� 像拉入群集部署。

在 env 键下，将 GKE_CLUSTER 的值更改为群集的名称，将 GKE_ZONE 更改为群集区域，将 DEPLOYMENT_NAME 更改为部署的名称，以及将 IMAGE 更改为� 像的名称。

如果配置了部署环境，请将 environment 的值更改为环境的名称。如果未配置环境，则� 除 environment 键。

YAML

# 此工作流使用未经 GitHub 认证的操作。
# 它们由第三方提供，并受
# 单独的服务条款、隐私政策和支持
# 文档管理。

name: Build and Deploy to GKE

on:
  push:
    branches:
      - main

env:
  PROJECT_ID: ${{ secrets.GKE_PROJECT }}
  GKE_CLUSTER: cluster-1    # Add your cluster name here.
  GKE_ZONE: us-central1-c   # Add your cluster zone here.
  DEPLOYMENT_NAME: gke-test # Add your deployment name here.
  IMAGE: static-site

jobs:
  setup-build-publish-deploy:
    name: Setup, Build, Publish, and Deploy
    runs-on: ubuntu-latest
    environment: production

    steps:
    - name: Checkout
      uses: actions/checkout@v2

    # Setup gcloud CLI
    - uses: google-github-actions/setup-gcloud@94337306dda8180d967a56932ceb4ddcf01edae7
      with:
        service_account_key: ${{ secrets.GKE_SA_KEY }}
        project_id: ${{ secrets.GKE_PROJECT }}

    # Configure Docker to use the gcloud command-line tool as a credential
    # helper for authentication
    - run: |-
        gcloud --quiet auth configure-docker

    # Get the GKE credentials so we can deploy to the cluster
    - uses: google-github-actions/get-gke-credentials@fb08709ba27618c31c09e014e1d8364b02e5042e
      with:
        cluster_name: ${{ env.GKE_CLUSTER }}
        location: ${{ env.GKE_ZONE }}
        credentials: ${{ secrets.GKE_SA_KEY }}

    # Build the Docker image
    - name: Build
      run: |-
        docker build \
          --tag "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA" \
          --build-arg GITHUB_SHA="$GITHUB_SHA" \
          --build-arg GITHUB_REF="$GITHUB_REF" \
          .

    # Push the Docker image to Google Container Registry
    - name: Publish
      run: |-
        docker push "gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA"

    # Set up kustomize
    - name: Set up Kustomize
      run: |-
        curl -sfLo kustomize https://github.com/kubernetes-sigs/kustomize/releases/download/v3.1.0/kustomize_3.1.0_linux_amd64
        chmod u+x ./kustomize

    # Deploy the Docker image to the GKE cluster
    - name: Deploy
      run: |-
        ./kustomize edit set image gcr.io/PROJECT_ID/IMAGE:TAG=gcr.io/$PROJECT_ID/$IMAGE:$GITHUB_SHA
        ./kustomize build . | kubectl apply -f -
        kubectl rollout status deployment/$DEPLOYMENT_NAME
        kubectl get services -o wide

其他资源

有关这些示例中使用的工具的详细信息，请参阅以下文档：

有关完整的入门工作流程，请参阅“生成并部署到 GKE”工作流程。
有关更多入门工作流程和随附代� �，请参阅 Google 的 GitHub Actions 示例工作流程。
Kubernetes YAML 定制引擎：Kustomize。
Google Kubernetes Engine 文档中的“部署容器化的 web 应用程序”。

本文内容

简介