使用 Github Actions 将代码直接部署到 AWS EC2 实例

Question

正如标题所说，我正在尝试使用Github Actions将我的Laravel-Angular应用程序直接从Github 部署到AWS EC2实例。

在我的应用程序中，有 3 个Angular 8+项目需要在部署前构建。 其中 laravel 不需要构建。

可用的解决方案建议使用AWS Elastic Beanstalk来部署代码。 但是，如果要这样做，如何将弹性 beantalk 附加到现有实例还不够清楚。

有没有办法在不使用Elastic Beanstalk的情况下将代码部署到AWS EC2 ？

这是我的Github Actions build.yml：

name: Build Develop Branch

on:
  push:
    branches: [ develop ]
  pull_request:
    branches: [ develop ]

jobs:
  build:

    runs-on: ubuntu-latest

    strategy:
      matrix:
        node-version: [14.x]

    steps:
    - name: Code Checkout
      uses: actions/checkout@v2
    - name: Use Node.js ${{ matrix.node-version }}
      uses: actions/setup-node@v1
      with:
        node-version: ${{ matrix.node-version }}
    - name: App 1 npm install
      run: npm install
      working-directory: angular-app-1
    - name: App 1 Build
      run: npm run build:staging
      working-directory: angular-app-1
    - name: App 2 npm install
      run: npm install
      working-directory: angular-app-2
    - name: App 2 Build
      run: node node_modules/@angular/cli/bin/ng build --configuration=staging
      working-directory: angular-app-2
    - name: App 3 npm install
      run: npm install
      working-directory: angular-app-3
    - name: App 3 Build
      run: node node_modules/@angular/cli/bin/ng build --configuration=staging
      working-directory: angular-app-3

Answer 1

有没有一种方法可以在不使用 Elastic Beanstalk 的情况下将代码部署到 AWS EC2？

我找到了一种使用GitHub Actions部署到 EC2 实例（或通过ssh接受rsync命令的任何服务器）的简单方法。

我在 repo 的.github/workflows文件夹中有一个简单的文件，只要对我的 GitHub repo 进行推送，该GitHub Actions 就会运行以部署到我的 EC2 实例。

没有混乱，没有大惊小怪，没有特殊的咒语或拜占庭式的 AWS 配置细节。

文件.github/workflows/pushtoec2.yml ：

name: Push-to-EC2

on: push

jobs:
  deploy:
    name: Push to EC2 Instance
    runs-on: ubuntu-latest

    steps:
      - name: Checkout the code
        uses: actions/checkout@v1

      - name: Deploy to my EC2 instance
        uses: easingthemes/ssh-deploy@v2.1.5
        env:
          SSH_PRIVATE_KEY: ${{ secrets.EC2_SSH_KEY }}
          SOURCE: "./"
          REMOTE_HOST: "ec2-34-213-48-149.us-west-2.compute.amazonaws.com"
          REMOTE_USER: "ec2-user"
          TARGET: "/home/ec2-user/SampleExpressApp"

上面使用的ssh 部署GitHub 操作的详细信息。

Answer 2

真正的最终编辑

一年后，我终于抽出时间来制作教程： https://github.com/Andrew-Chen-Wang/cookiecutter-django-ec2-github 。

我找到了一个Medium 教程，如果有人想使用 Code Pipeline，它也值得一提（有一些不同之处；我将我的文件存储在 GitHub 上，而 Medium 教程在 S3 上。我创建了一个自定义 VPC，而其他作者没有).

---

较早的最终编辑

AWS 终于为带有 GitHub 存储库的 CodeDeploy 制作了一个简洁的教程： https://docs.aws.amazon.com/codedeploy/latest/userguide/tutorials-github-prerequisites.html在那里看看并享受:)

与 ECS 教程一样，我们使用 Parameter Store 来存储我们的秘密。 AWS 之前希望我们获取机密的方式是通过 bash 脚本中的一个脚本： https://aws.amazon.com/blogs/mt/use-parameter-store-to-securely-access-secrets-and-config-数据在 aws-codedeploy/

例如：

password=$(aws ssm get-parameters --region us-east-1 --names MySecureSQLPassword --with-decryption --query Parameters[0].Value)
password=`echo $password | sed -e 's/^"//' -e 's/"$//'`
mysqladmin -u root password $password

---

新编辑（2020 年 12 月 24 日）：我想我已经搞定了。 下面我指出了为 AWS ECS捐赠任何东西。 我已经转移到自我部署设置。 如果你看一下 bin/scripts，我正在利用 supervisord 和 gunicorn（用于 Python web 开发）。 但是在 EC2 的上下文中，您可以简单地将 AppSpec.yml 指向这些脚本！ 希望对大家有帮助！

在我开始之前：

这不是一个完整的答案。 这不是一个完整的演练，但有很多提示和一些代码可以帮助您设置某些 AWS 东西，例如 ALB 和您存储库中的文件，以使其正常工作。 这个答案更像是我昨晚试图让 ECS 工作的冲刺运行中混杂在一起的几条线索。

我也没有足够的积分来发表评论或聊天……这是我能提供的最好的东西。

快速链接（不过你应该跳过这两点）：

1. 检查一下： https://docs.aws.amazon.com/codedeploy/latest/userguide/instances-ec2-configure.html
2. 我没有足够的积分来发表评论或聊天……不过，这也不是一个完整的答案，因为我试图先从 GH 完成 ECS 部署，然后再从 GH 转移到 EC2。 无论如何...
3. 最后一个编辑：这听起来像是一种营销策略，但使用 GitHub 操作和 workflow_dispatch 的正确实现位于Donate Anything 的 GitHub 存储库中。 您会在下方找到相同的 ECS 工作。 请注意，我将 GitHub 操作更改为使用 Docker Hub，因为它是免费的（如果您要使用 ECS，对我来说更便宜，因为 AWS ECR 很昂贵）。

编辑：ECS 部署现在有效。 将很快开始进行 EC2 部署。

编辑 2：我添加了 Donate Anything 回购协议。 此外，我不确定直接 EC2 部署是否可行，至少对我而言，因为安装脚本有点奇怪。 但是，我仍然没有找到时间去 EC2。 同样，如果有人愿意分享他们的时间，请这样做并做出贡献！

我确实想警告大家，安全组非常重要。 这困扰了我很长时间，所以请确保你把它们弄对了。 在 ECS 教程中，我教你我是怎么做的。

---

完整非完整答案：

我现在正在使用 GitHub 操作在此 repo中处理此问题，并在此处针对 ECS 处理另一个问题。 我在 EC2 上还没有开始太多，但是测试的基本概要是这样的：

至关重要的

• 您需要先尝试从 AWS CLI 进行部署。 这是因为 AWS 操作还没有专门用于部署到 EC2 的操作。
• 写下这些陈述中的每一个。 我们稍后将需要它们来执行 GitHub 操作。

测试此 AWS 设置时的一些提示：

• 在使用 CodeDeploy 之前，您需要一个 EC2 实例、一个 Application Load Balancer（您将在 Elastic Load Balancer 下找到它）和一个目标组（您在 ALB 设置期间创建）。 Go 到目标组，右键单击该组，然后注册您的实例。
• 要从 CodeDeploy 进行部署，请创建一个新应用程序。 创建一个新的部署组。 我认为，对于您的设置，您应该执行就地部署类型而不是蓝/绿部署类型。
• 最后，在 CLI 上进行测试，您应该运行您在此处看到的代码： https://docs.aws.amazon.com/codedeploy/latest/userguide/tutorials-wordpress-deploy-application.html#tutorials-wordpress-deploy-应用程序创建部署-cli
  • 请注意，您可能想从这里开始（使用 S3 作为存储最新代码的位置。之后您可以删除它，因为我相信删除请求不会产生费用）： https://docs.aws.amazon .com/codedeploy/latest/userguide/tutorials-wordpress-upload-application.html我个人不知道 GitHub OAuth 集成是否有效。 我之前尝试过一次（虽然非常业余，即不知道我之前在做什么）但什么也没发生，所以...我只是坚持使用该教程。

您的测试纲要将如何显示：

• 对我来说，对于我的 ECS 存储库，我花了整整 10 个小时尝试逐步正确配置所有内容，例如 GitHub 操作。 对你来说，你也应该这样做。 想象你是代码：弄清楚你需要从哪里开始。
• 啊哈。 我应该首先弄清楚 CodeDeploy。 让我们首先调整一个 appspec.yaml 文件，appspec 文件是 CodeDeploy 如何处理所有内容的挂钩。 不幸的是，我目前在这里遇到这个问题，但那是因为 AppSpec 文件的 EC2 和 ECS 语法不同。 幸运的是，EC2 没有任何特殊区域。 只需正确设置文件和挂钩即可。 我测试的一个例子：

version: 0.0
os: linux

files:
  - source: /
    destination: /code

hooks:
  BeforeInstall:
    - location: aws_scripts/install_dependencies
      timeout: 300
      runas: root
  ApplicationStop:
    - location: aws_scripts/start_server
      runas: root

GitHub动作：

你至少需要什么：

jobs:
  deploy:
    name: Deploy
    runs-on: ubuntu-latest

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

    - name: Configure AWS credentials
      uses: aws-actions/configure-aws-credentials@v1
      with:
        aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
        aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
        # TODO Change your AWS region here!
        aws-region: us-east-2

签出代码对于......好吧......获取代码是必要的。

对于 AWS 凭证的配置，您需要使用适当的 IAM 凭证将AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY添加到您的 GitHub 机密中。 为此，我认为唯一需要的 IAM 角色是完整的 CodeDeploy 东西。

部署代码：

这是您在到达此步骤之前应该尝试的测试代码的时间。 现在您的工作流程已设置，让我们将 CLI 中的代码粘贴到您的操作中。

    - name: Deploying with CodeDeploy
      id: a-task
      env:
        an-environment-variable: anything you want
      run: |
        echo "Your CLI code should be placed here"

很抱歉，如果这让您感到困惑，而不是您正在寻找的内容，或者想要一个完整的教程。 我也没有真正让这个工作，但自从我上次尝试以来也已经有一段时间了，而且我最后一次尝试时，我什至不知道什么是 EC2 实例......我只是做了一个独立的 EC2实例并使用 rsync 传输我的文件。 希望我所写的是一些可以引导您轻松找到解决方案的线索。

如果你成功了，请在这里分享它： https://github.com/Andrew-Chen-Wang/cookiecutter-django-ec2-gh-action这样就没有其他人会遭受 AWS 部署的痛苦。 ..

Answer 3

首先，你需要在AWS上通过本教程go来设置你的EC2服务器，以及在CodeDeploy中配置Application and Deployment Group： 教程：使用CodeDeploy从GitHub部署一个应用

然后，您可以在 GitHub Actions 中使用以下工作流程在推送时部署您的代码。 您实际上是使用 AWS CLI 创建新的部署。 将 CLI 的 AWS 凭证存储在 GitHub Secrets 中。

以下是部署 Node 应用程序的示例：

name: Deploy to AWS

on:
  push:
    branches: [ main ]

jobs:
  deploy:
    name: Deploy AWS
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [12.x]
        app-name: ['your-codedeploy-application']
        deployment-group: ['your-codedeploy-deploy-group']
        repo: ['username/repository-name']
        
    steps:
      - uses: actions/checkout@v2
      
      - name: Use Node.js ${{ matrix.node-version }}
        uses: actions/setup-node@v1
        with:
          node-version: ${{ matrix.node-version }}
          
      - name: Install dependencies
        run: npm install
      
      - name: Build app
        run: npm run build

      - name: Install AWS CLI 
        run: |
          curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
          unzip awscliv2.zip
          sudo ./aws/install --update
      
      - name: Configure AWS credentials
        uses: aws-actions/configure-aws-credentials@v1
        with:
          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
          aws-session-token: ${{ secrets.AWS_SESSION_TOKEN }}
          aws-region: us-east-1
          
      - name: Deploy to AWS
        run: |
          aws deploy create-deployment \
          --application-name ${{ matrix.app-name }} \
          --deployment-config-name CodeDeployDefault.OneAtATime \
          --deployment-group-name ${{ matrix.deployment-group }} \
          --description "GitHub Deployment for the ${{ matrix.app-name }}-${{ github.sha }}" \
          --github-location repository=${{ matrix.repo }},commitId=${{ github.sha }}