View a markdown version of this page

Criar um fluxo de trabalho de imagem - EC2 Image Builder

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á.

Criar um fluxo de trabalho de imagem

Ao criar um fluxo de trabalho de imagem, você tem mais controle sobre o processo de criação de imagens. Você pode especificar o fluxo de trabalho que é executado quando o Image Builder cria sua imagem, os fluxos de trabalho que são executados quando ele testa a imagem e o fluxo de trabalho que é executado quando ele distribui a imagem. Você também pode especificar uma chave gerenciada pelo cliente para criptografar os recursos do fluxo de trabalho. Para saber mais sobre criptografia para seus recursos de fluxo de trabalho, consulte Gerenciamento de criptografia e chaves no Image Builder.

Para a criação de imagens, você pode especificar um fluxo de trabalho de estágio de construção, um ou mais fluxos de trabalho de estágio de teste e um fluxo de trabalho de estágio de distribuição. Você pode até mesmo pular uma etapa por completo, dependendo de suas necessidades. Você configura as ações que seu fluxo de trabalho executa no documento de definição do YAML que o fluxo de trabalho usa. Para obter mais informações sobre sintaxe para seu documento do YAML, consulte Criar um documento de fluxo de trabalho do YAML.

Para criar um novo fluxo de trabalho de construção, teste ou distribuição, selecione a guia que corresponda ao seu ambiente.

Console de gerenciamento da AWS

É possível seguir o processo a seguir para criar um novo fluxo de trabalho no console do Image Builder.

  1. Abra o console do EC2 Image Builder em https://console.aws.amazon.com/imagebuilder/.

  2. Escolha Fluxos de trabalho de imagem no painel de navegação. Isso exibe uma lista de fluxos de trabalho de imagem de propriedade da sua conta ou aos quais sua conta tem acesso.

    nota

    A lista sempre inclui os recursos de fluxo de trabalho gerenciado pela Amazon que o Image Builder usa para seus fluxos de trabalho padrão. Para ver os detalhes desses fluxos de trabalho, selecione o link Fluxo de trabalho.

  3. Para criar um novo fluxo de trabalho, escolha Criar fluxo de trabalho de imagem. Isso exibe a página Criar fluxo de trabalho de imagem.

  4. Configure os detalhes do seu novo fluxo de trabalho. Selecione o tipo de fluxo de trabalho próximo à parte superior do formulário: escolha Criar para criar um fluxo de trabalho de criação, Teste para criar um fluxo de trabalho de teste ou Distribuição para criar um fluxo de trabalho de distribuição. O tipo de fluxo de trabalho é mapeado para o Type valor na API (BUILDTEST,, ouDISTRIBUTION). O Image Builder preencherá a lista Modelos com base nessa opção. Todas as outras etapas são iguais para fluxos de trabalho de criação, teste e distribuição.

    Geral

    A seção geral inclui configurações que se aplicam ao seu recurso de fluxo de trabalho, como nome e descrição. As configurações gerais incluem o seguinte:

    • Nome do fluxo de trabalho de imagem (obrigatório): o nome do seu fluxo de trabalho de imagem. O nome deve ser exclusivo em sua conta. Os nomes podem ter até 128 caracteres. Os caracteres válidos incluem letras, números, espaços - e _.

    • Versão (obrigatória): a versão semântica do recurso de fluxo de trabalho a ser criado (major.minor.patch).

    • Descrição (opcional): opcionalmente, adicione uma descrição para seu fluxo de trabalho.

    • Chave do KMS (opcional): você pode criptografar seus recursos de fluxo de trabalho com uma chave gerenciada pelo cliente. Para obter mais informações, consulte Criptografar fluxos de trabalho de imagens com uma chave gerenciada pelo cliente.

    Documento de definição

    O documento de fluxo de trabalho do YAML contém todas as configurações do seu fluxo de trabalho.

    Conceitos básicos

    • Para começar com um modelo padrão do Image Builder como linha de base para seu fluxo de trabalho, selecione a opção Iniciar com base em modelos. Essa opção é selecionada por padrão. Após escolher qual modelo usar na lista Modelos, o sistema vai copiar a configuração padrão do modelo selecionado para o Conteúdo do seu novo documento de fluxo de trabalho, no qual você poderá fazer alterações.

    • Para definir seu documento de fluxo de trabalho do zero, selecione a opção Começar do zero. Isso preencherá o Conteúdo com um breve resumo de algumas partes importantes do formato do documento para ajudar você a começar.

    O painel Conteúdo inclui uma barra de status na parte inferior que mostra avisos ou erros do seu documento do YAML. Para obter mais informações sobre como criar um documento de fluxo de trabalho do YAML, consulte Criar um documento de fluxo de trabalho do YAML.

  5. Após concluir seu fluxo de trabalho ou se quiser salvar o progresso e retornar posteriormente, escolha Criar fluxo de trabalho.

AWS CLI

Antes de executar o create-workflow comando no AWS CLI, você deve criar o documento YAML que contém todas as configurações do seu fluxo de trabalho. Para obter mais informações, consulte Criar um documento de fluxo de trabalho do YAML.

O exemplo a seguir mostra como criar um fluxo de trabalho de compilação com o comando create-workflow da AWS CLI . O parâmetro --data se refere a um documento do YAML que contém a configuração de compilação para o fluxo de trabalho que você cria.

Exemplo: criar fluxo de trabalho

aws imagebuilder create-workflow --name example-build-workflow --semantic-version 1.0.0 --type BUILD --data file://example-build-workflow.yml

Saída:

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

O exemplo a seguir mostra como criar um fluxo de trabalho de teste com o comando create-workflow da AWS CLI . O --data parâmetro se refere a um documento YAML que contém a configuração de teste para o fluxo de trabalho que você cria.

Exemplo: criar fluxo de trabalho de teste

aws imagebuilder create-workflow --name example-test-workflow --semantic-version 1.0.0 --type TEST --data file://example-test-workflow.yml

Saída:

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}

O exemplo a seguir mostra como criar um fluxo de trabalho de distribuição com o comando https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html AWS CLI create-workflow. O --data parâmetro se refere a um documento YAML que contém a configuração de distribuição para o fluxo de trabalho que você cria.

Exemplo: Criar fluxo de trabalho de distribuição 

aws imagebuilder create-workflow --name example-distribution-workflow --semantic-version 1.0.0 --type DISTRIBUTION --data file://example-distribution-workflow.yml

Saída:

{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/distribution/example-distribution-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}