Integrando GitHub ações em um fluxo de trabalho - Amazon CodeCatalyst

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Integrando GitHub ações em um fluxo de trabalho

Uma GitHub ação é muito parecida com uma CodeCatalyst ação, exceto pelo fato de ter sido desenvolvida para uso com GitHub fluxos de trabalho. Para obter detalhes sobre GitHub ações, consulte a documentação de GitHub ações.

Você pode usar GitHub ações junto com CodeCatalyst ações nativas em um CodeCatalyst fluxo de trabalho.

Há duas maneiras de adicionar uma GitHub ação a um CodeCatalyst fluxo de trabalho:

  • Você pode selecionar a GitHub Ação em uma lista organizada no CodeCatalyst console. Várias GitHub ações populares estão disponíveis. Para ter mais informações, consulte Adicionando uma ação com curadoria GitHub .

  • Se a GitHub Ação que você deseja usar não estiver disponível no CodeCatalyst console, você poderá adicioná-la usando uma ação GitHub Ações.

    Uma ação de GitHub ações é uma CodeCatalyst ação que envolve uma GitHub ação e a torna compatível com CodeCatalyst fluxos de trabalho.

    Aqui está um exemplo de uma ação de GitHub ações envolvendo a ação GitHubSuper-Linter:

    Actions: GitHubAction: Identifier: aws/github-actions-runner@v1 Configuration: Steps: - name: Lint Code Base uses: github/super-linter@v4 env: VALIDATE_ALL_CODEBASE: "true" DEFAULT_BRANCH: main

    No código anterior, a ação CodeCatalyst GitHub Actions (identificada poraws/github-actions-runner@v1) envolve a ação Super-Linter (identificada porgithub/super-linter@v4), fazendo com que ela funcione em um fluxo de trabalho. CodeCatalyst

    Para ter mais informações, consulte Adicionando a ação "GitHub Ações”.

Todas as GitHub ações, curadas ou não, devem ser agrupadas dentro de uma ação GitHub Actions (aws/github-actions-runner@v1), conforme mostrado no exemplo anterior. O invólucro é necessário para que a ação funcione corretamente.

Como as GitHub ações são diferentes das CodeCatalyst ações?

GitHub As ações usadas em um CodeCatalyst fluxo de trabalho não têm o mesmo nível de acesso e integração com AWS CodeCatalyst recursos (como ambientes e problemas) que CodeCatalyst as ações.

GitHub As ações podem interagir com outras CodeCatalyst ações no fluxo de trabalho?

Sim. Por exemplo, GitHub as ações podem usar variáveis produzidas por outras CodeCatalyst ações como entrada e também podem compartilhar parâmetros de saída e artefatos com CodeCatalyst ações. Para obter mais informações, consulte Exportar um parâmetro GitHub de saída para que outras ações possam usá-lo e Fazendo referência a um parâmetro GitHub de saída.

Quais GitHub ações posso usar?

Você pode usar qualquer GitHub ação disponível no CodeCatalyst console e qualquer GitHub ação disponível no GitHubMarketplace. Se você decidir usar uma GitHub Ação do Marketplace, tenha em mente as seguintes limitações.

GitHub Limitações das ações em CodeCatalyst

  • GitHub Ações que dependem internamente do githubcontexto ou em que recursos GitHub específicos de referência não funcionarão. CodeCatalyst Por exemplo, as ações a seguir não funcionarão em CodeCatalyst:

    • Ações que tentam adicionar, alterar ou atualizar GitHub recursos. Os exemplos incluem ações que atualizam pull requests ou criam problemas no GitHub.

    • Quase todas as ações listadas em https://github.com/actions.

  • GitHub As ações que são ações de contêiner do Docker funcionarão, mas devem ser executadas pelo usuário padrão do Docker (root). Não execute a ação como usuário 1001. (No momento em que este artigo foi escrito, o usuário 1001 trabalhava no GitHub, mas não no CodeCatalyst.) Para obter mais informações, consulte o tópico USUÁRIO em Suporte do Dockerfile para GitHub ações.

Para obter uma lista das GitHub ações disponíveis por meio do CodeCatalyst console, consulteAdicionando uma ação com curadoria GitHub .

Como adiciono uma GitHub ação (etapas de alto nível)?

As etapas de alto nível para adicionar uma GitHub ação a um CodeCatalyst fluxo de trabalho são as seguintes:

  1. No seu CodeCatalyst projeto, você cria um fluxo de trabalho. O fluxo de trabalho é onde você define como criar, testar e implantar seu aplicativo. Para ter mais informações, consulte Introdução aos fluxos de trabalho.

  2. No fluxo de trabalho, você adiciona uma GitHub ação com curadoria ou adiciona a ação GitHub Ações.

  3. Você faz um dos seguintes:

    • Se você optar por adicionar uma ação com curadoria, configure-a. Para ter mais informações, consulte Adicionando uma ação com curadoria GitHub .

    • Se você optar por adicionar uma ação não curada, na ação GitHubAções, cole o código YAML da GitHub Ação. Você pode encontrar esse código na página de detalhes da GitHub Ação escolhida no GitHubMarketplace. Provavelmente, você precisará modificar um pouco o código para que ele funcione CodeCatalyst. Para ter mais informações, consulte Adicionando a ação "GitHub Ações”.

  4. (Opcional) No fluxo de trabalho, você adiciona outras ações, como as ações de criação e teste. Para ter mais informações, consulte Crie, teste e implante com fluxos de trabalho em CodeCatalyst.

  5. Você inicia o fluxo de trabalho manual ou automaticamente por meio de um gatilho. O fluxo de trabalho executa a GitHub Ação e quaisquer outras ações no fluxo de trabalho. Para ter mais informações, consulte Iniciando um fluxo de trabalho executado manualmente.

Para obter etapas detalhadas, consulte:

A GitHub ação é executada GitHub?

Não. A GitHub ação é CodeCatalyst executada usando máquinas CodeCatalyst de construção.

Também posso usar GitHub fluxos de trabalho?

Não.