Cloud deployment · Gitlab 中文文檔

# Cloud deployment > 原文：[https://docs.gitlab.com/ee/ci/cloud_deployment/](https://docs.gitlab.com/ee/ci/cloud_deployment/) * [AWS](#aws) * [Run AWS commands from GitLab CI/CD](#run-aws-commands-from-gitlab-cicd) * [Use an AWS Elastic Container Registry (ECR) image in your CI/CD](#use-an-aws-elastic-container-registry-ecr-image-in-your-cicd) * [Deploy your application to the AWS Elastic Container Service (ECS)](#deploy-your-application-to-the-aws-elastic-container-service-ecs) # Cloud deployment[](#cloud-deployment "Permalink") 與主要的云提供商進行交互可能已成為交付過程中非常需要的任務. GitLab 通過提供預安裝了所需庫和工具的 Docker 映像，減輕了這一過程的麻煩. 通過在 CI / CD 管道中引用它們，您將能夠更輕松地與所選的云提供商進行交互. ## AWS[](#aws "Permalink") GitLab 提供了可用于[從 GitLab CI / CD 運行 AWS 命令的](#run-aws-commands-from-gitlab-cicd) Docker 映像，并提供了一個模板，以使其更易于[部署到 AWS](#deploy-your-application-to-the-aws-elastic-container-service-ecs) . ### Run AWS commands from GitLab CI/CD[](#run-aws-commands-from-gitlab-cicd "Permalink") 在 GitLab 12.6 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/31167) . GitLab 的 AWS Docker 映像提供了[AWS Command Line Interface](https://aws.amazon.com/cli/) ，可讓您運行`aws`命令. 作為部署策略的一部分，您可以通過指定[GitLab 的 AWS Docker 映像](https://gitlab.com/gitlab-org/cloud-deploy)直接從`.gitlab-ci.yml`運行`aws`命令. 需要一些憑據才能運行`aws`命令： 1. 如果您還沒有[一個 AWS 賬戶](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-set-up.html) ，請注冊一個. 2. 登錄到控制臺并創建[一個新的 IAM 用戶](https://console.aws.amazon.com/iam/home#/home) . 3. 選擇您新創建的用戶以訪問其詳細信息. 導航到**安全憑證>創建新的訪問密鑰** . **注意：**將生成新的**訪問密鑰 ID**和**秘密訪問密鑰**對. 請立即記錄下來. 4. 在您的 GitLab 項目中，轉到**"設置">" CI / CD"** . 將以下內容設置為[環境變量](../variables/README.html#gitlab-cicd-environment-variables) （請參見下表）： * 訪問密鑰 ID. * 秘密訪問密鑰. * 地區代碼. 您可以檢查[AWS 區域終端節點列表](https://docs.aws.amazon.com/general/latest/gr/rande.html#regional-endpoints) . 您可能想要檢查要使用的 AWS 服務[在所選區域中](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/)是否[可用](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) . | 環保變量名 | Value | | --- | --- | | `AWS_ACCESS_KEY_ID` | 您的訪問密鑰 ID | | `AWS_SECRET_ACCESS_KEY` | 您的秘密訪問密鑰 | | `AWS_DEFAULT_REGION` | 您的地區代碼 | 5. 現在，您可以在此項目的`.gitlab-ci.yml`文件中使用`aws`命令： ``` deploy: stage: deploy image: registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest # see the note below script: - aws s3 ... - aws create-deployment ... ``` **注意：**上例中使用的映像（ `registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest` ）托管在[GitLab 容器注冊表中](../../user/packages/container_registry/index.html) ，可以使用. 或者，將映像替換為 AWS ECR 上托管的映像. ### Use an AWS Elastic Container Registry (ECR) image in your CI/CD[](#use-an-aws-elastic-container-registry-ecr-image-in-your-cicd "Permalink") 除了引用托管在 GitLab 注冊表上的映像外，您還可以引用托管在任何第三方注冊表上的映像，例如[Amazon Elastic Container Registry（ECR）](https://aws.amazon.com/ecr/) . 為此， [將映像推送到 ECR 存儲庫中](https://docs.aws.amazon.com/AmazonECR/latest/userguide/docker-push-ecr-image.html) . 然后在`.gitlab-ci.yml`文件中引用它，并替換`image`路徑以指向您的 ECR 圖像. ### Deploy your application to the AWS Elastic Container Service (ECS)[](#deploy-your-application-to-the-aws-elastic-container-service-ecs "Permalink") 在 GitLab 12.9 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/207962) . GitLab 提供了一系列[CI 模板，您可以將其包含在項目中](../yaml/README.html#include) . 要自動將應用程序部署到[Amazon Elastic Container Service](https://aws.amazon.com/ecs/) （AWS ECS）集群，您可以在`.gitlab-ci.yml`文件中`include` `Deploy-ECS.gitlab-ci.yml`模板. GitLab 還提供了可在您的`gitlab-ci.yml`文件中使用的[Docker 映像](https://gitlab.com/gitlab-org/cloud-deploy/-/tree/master/aws) ，以簡化使用 AWS 的工作： * 使用`registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest`以使用 AWS CLI 命令. * 使用`registry.gitlab.com/gitlab-org/cloud-deploy/aws-ecs:latest`將您的應用程序部署到 AWS ECS. 在開始此過程之前，您需要 AWS ECS 上的集群以及相關組件，例如 ECS 服務，ECS 任務定義，AWS RDS 上的數據庫等. [了解有關 AWS ECS 的更多信息](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/Welcome.html) . 在 AWS ECS 上完成所有設置后，請執行以下步驟： 1. 確保將您的 AWS 憑證設置為項目的環境變量. 您可以按照[上述步驟](#run-aws-commands-from-gitlab-cicd)完成此設置. 2. Add these variables to your project’s `.gitlab-ci.yml` file: ``` variables: CI_AWS_ECS_CLUSTER: my-cluster CI_AWS_ECS_SERVICE: my-service CI_AWS_ECS_TASK_DEFINITION: my-task-definition ``` Three variables are defined in this snippet: * `CI_AWS_ECS_CLUSTER` ：您要為部署目標的 AWS ECS 集群的名稱. * `CI_AWS_ECS_SERVICE` ：綁定到您的 AWS ECS 集群的目標服務的名稱. * `CI_AWS_ECS_TASK_DEFINITION` ：與上述服務綁定的任務定義的名稱. 您可以在[AWS ECS 儀表板上](https://console.aws.amazon.com/ecs/home)選擇目標集群后找到這些名稱： [![AWS ECS dashboard](https://img.kancloud.cn/5d/3c/5d3c5010a2a2ec418d4ab78a5c9e052f_1826x739.png)](../img/ecs_dashboard_v12_9.png) 3. 將此模板包括在`.gitlab-ci.yml` ： ``` include: - template: AWS/Deploy-ECS.gitlab-ci.yml ``` `Deploy-ECS`模板隨 GitLab 一起提供[，](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/AWS/Deploy-ECS.gitlab-ci.yml)可[在 GitLab.com 上獲得](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/AWS/Deploy-ECS.gitlab-ci.yml) . 4. 提交更新的`.gitlab-ci.yml`并將其推送到項目的存儲庫中，您就完成了！您的應用程序 Docker 映像將被重建并推送到 GitLab 注冊表中. 然后，目標任務定義將使用新 Docker 映像的位置進行更新，結果將在 ECS 中創建新的修訂版. 最后，您的 AWS ECS 服務將使用任務定義的新修訂版進行更新，從而使群集提取應用程序的最新版本. **警告：** [`Deploy-ECS.gitlab-ci.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/AWS/Deploy-ECS.gitlab-ci.yml)模板包括[`Jobs/Build.gitlab-ci.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Jobs/Build.gitlab-ci.yml)和[`Jobs/Deploy/ECS.gitlab-ci.yml`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/lib/gitlab/ci/templates/Jobs/Deploy/ECS.gitlab-ci.yml) "子模板". 不要單獨包括這些"子模板"，而僅包括主`Deploy-ECS.gitlab-ci.yml`模板. "子模板"旨在僅與主模板一起使用. 如果不包括主模板，它們可能會移動或發生意外更改，從而導致您的管道失敗. 此外，這些模板中的作業名稱可能會更改. 不要在您自己的管道中覆蓋這些作業的名稱，因為當名稱更改時，覆蓋將停止工作. 另外，如果您不希望使用`Deploy-ECS.gitlab-ci.yml`模板部署到 AWS ECS，則始終可以使用基于`aws-base` Docker 映像[為 ECS](https://docs.aws.amazon.com/cli/latest/reference/ecs/index.html#cli-aws-ecs)運行您自己的[AWS CLI 命令](https://docs.aws.amazon.com/cli/latest/reference/ecs/index.html#cli-aws-ecs) . ``` deploy: stage: deploy image: registry.gitlab.com/gitlab-org/cloud-deploy/aws-base:latest script: - aws ecs register-task-definition ... ```