Crie, teste e implante com fluxos de trabalho em CodeCatalyst

Depois de escrever o código do aplicativo em um ambiente de CodeCatalyst desenvolvimento e enviá-lo para o repositório de CodeCatalyst origem, você está pronto para implantá-lo. A maneira de fazer isso automaticamente é por meio de um fluxo de trabalho.

Um fluxo de trabalho é um procedimento automatizado que descreve como criar, testar e implantar seu código como parte de um sistema de integração contínua e entrega contínua (CI/CD). Um fluxo de trabalho define uma série de etapas ou ações a serem executadas durante a execução de um fluxo de trabalho. Um fluxo de trabalho também define os eventos, ou gatilhos, que fazem com que o fluxo de trabalho seja iniciado. Para configurar um fluxo de trabalho, você cria um arquivo de definição de fluxo de trabalho usando o editor visual ou YAML do CodeCatalyst console.

dica

Para ver rapidamente como você pode usar fluxos de trabalho em um projeto, crie um projeto com um blueprint. Cada blueprint implanta um fluxo de trabalho funcional que você pode revisar, executar e experimentar.

Sobre o arquivo de definição do fluxo de trabalho

Um arquivo de definição de fluxo de trabalho é um arquivo YAML que descreve seu fluxo de trabalho. O arquivo é armazenado em uma ~/.codecatalyst/workflows/ pasta na raiz do seu repositório de origem. O arquivo pode ter uma extensão .yml ou .yaml.

Veja a seguir um exemplo de um arquivo simples de definição de fluxo de trabalho. Explicamos cada linha desse exemplo na tabela a seguir.

Name: MyWorkflow
SchemaVersion: 1.0
RunMode: QUEUED
Triggers:
  - Type: PUSH
    Branches:
      - main
Actions:
  Build:
    Identifier: aws/build@v1
    Inputs:
      Sources:
        - WorkflowSource
    Configuration:     
      Steps:
        - Run: docker build -t MyApp:latest .

Linha	Descrição
Name: MyWorkflow	Especifica o nome do fluxo de trabalho. Para obter mais informações sobre a Name propriedade, consultePropriedades de nível superior.
SchemaVersion: 1.0	Especifica a versão do esquema do fluxo de trabalho. Para obter mais informações sobre a SchemaVersion propriedade, consultePropriedades de nível superior.
RunMode: QUEUED	Indica como CodeCatalyst lida com várias execuções. Para obter mais informações sobre o modo de execução, consulteConfigurando o comportamento de enfileiramento das execuções.
Triggers:	Especifica a lógica que fará com que a execução de um fluxo de trabalho seja iniciada. Para obter mais informações sobre gatilhos, consulte Iniciando um fluxo de trabalho executado automaticamente com gatilhos.
- Type: PUSH Branches: - main	Indica que o fluxo de trabalho deve ser iniciado sempre que você envia o código para a main ramificação do repositório de origem padrão. Para obter mais informações sobre a fonte do fluxo de trabalho, consulteConectando um fluxo de trabalho a um repositório de origem.
Actions:	Define as tarefas a serem executadas durante a execução de um fluxo de trabalho. Neste exemplo, a Actions seção define uma única ação chamadaBuild. Para obter mais informações sobre ações, consulteConfigurando as ações que um fluxo de trabalho executa.
Build:	Define as propriedades da Build ação. Para obter mais informações sobre a ação de criação, consulteConstruindo com fluxos de trabalho.
Identifier: aws/build@v1	Especifica o identificador exclusivo e codificado para a ação de criação.
Inputs: Sources: - WorkflowSource	Indica que a ação de criação deve procurar no repositório de WorkflowSource origem os arquivos necessários para concluir o processamento. Para ter mais informações, consulte Conectando um fluxo de trabalho a um repositório de origem.
Configuration:	Contém as propriedades de configuração que são específicas para a ação de construção.
Steps: - Run: docker build -t MyApp:latest .	Diz à ação de construção que crie uma imagem do Docker chamada MyApp e a marque comlatest.

Para obter uma lista completa de todas as propriedades disponíveis no arquivo de definição do fluxo de trabalho, consulte Definição de fluxo de trabalho YAML o.

Usando os editores visual e YAML do CodeCatalyst console

Para criar e editar o arquivo de definição do fluxo de trabalho, você pode usar seu editor preferido, mas recomendamos usar o editor visual ou o editor YAML do CodeCatalyst console. Esses editores oferecem validação útil de arquivos para ajudar a garantir que os nomes, valores, aninhamento, espaçamento, capitalização e assim por diante das propriedades YAML estejam corretos.

A imagem a seguir mostra um fluxo de trabalho no editor visual. O editor visual oferece uma interface de usuário completa para criar e configurar seu arquivo de definição de fluxo de trabalho. O editor visual inclui um diagrama de fluxo de trabalho (1) mostrando os principais componentes do fluxo de trabalho e uma área de configuração (2).

Como alternativa, você pode usar o editor YAML, mostrado na imagem a seguir. Use o editor YAML para colar blocos de código grandes (de um tutorial, por exemplo) ou para adicionar propriedades avançadas que não são oferecidas pelo editor visual.

Você pode alternar do editor visual para o editor YAML para ver o efeito que suas configurações têm no código YAML subjacente.

Descobrindo fluxos de trabalho

Você pode visualizar seu fluxo de trabalho na página de resumo dos fluxos de trabalho, junto com outros fluxos de trabalho que você configurou no mesmo projeto.

A imagem a seguir mostra a página de resumo dos fluxos de trabalho. Ele é preenchido com dois fluxos de trabalho: e. BuildToProdUnitTests Você pode ver que ambos foram executados algumas vezes. Você pode escolher Execuções recentes para ver rapidamente o histórico de execuções ou escolher o nome do fluxo de trabalho para ver o código YAML do fluxo de trabalho e outras informações detalhadas.

Visualizando detalhes da execução do fluxo de trabalho

Você pode ver os detalhes da execução de um fluxo de trabalho escolhendo a execução na página de resumo dos fluxos de trabalho.

A imagem a seguir mostra os detalhes de uma execução de fluxo de trabalho chamada Run-CC11d que foi iniciada automaticamente em uma confirmação na origem. O diagrama do fluxo de trabalho indica que uma ação falhou (1). Você pode navegar até os registros (2) para ver as mensagens de registro detalhadas e solucionar problemas. Para obter mais informações sobre execuções de fluxo de trabalho, consulteExecutar um fluxo de trabalho.

Próximas etapas

Para saber mais sobre os conceitos de fluxos de trabalho, consulteConceitos de fluxos de trabalho.

Para criar seu primeiro fluxo de trabalho, consulteIntrodução aos fluxos de trabalho.