

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
<a name="image-workflow-create-resource"></a>

Ao criar um fluxo de trabalho de imagem, você tem mais controle sobre o processo de criação de imagens. É possível especificar qual fluxo de trabalho será executado quando o Image Builder criar sua imagem e quais fluxos de trabalho serão executados quando ele testar 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](data-protection.md#ib-encryption).

Para a criação de imagens, você pode especificar um fluxo de trabalho do estágio de compilação e um ou mais fluxos de trabalho do estágio de teste. Dependendo de suas necessidades, é possível até mesmo ignorar totalmente o estágio de compilação ou teste. 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](image-workflow-create-document.md).

Para obter as etapas de criação de um novo fluxo de trabalho de compilação ou teste, selecione a guia que corresponde ao ambiente que você usará.

------
#### [ 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/](https://console.aws.amazon.com/imagebuilder/).

1. 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**  
Você sempre verá os recursos de fluxo de trabalho gerenciado pela Amazon que o Image Builder usa para seus fluxos de trabalho padrão em sua lista. Para exibir os detalhes desses fluxos de trabalho, você pode selecionar o link **Fluxo de trabalho**.

1. 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**.

1. Configure os detalhes do seu novo fluxo de trabalho. Para criar um fluxo de trabalho de compilação, selecione a opção **Compilar** na parte superior do formulário. Para criar um fluxo de trabalho de teste, selecione a opção **Testar** na parte superior do formulário. O Image Builder preencherá a lista **Modelos** com base nessa opção. Todas as outras etapas são as mesmas para os fluxos de trabalho de compilação e teste.

**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](data-protection.md#ib-workflow-encrypt-cmk).

**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](image-workflow-create-document.md).

1. 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html)** comando no AWS CLI, você deve criar o documento YAML que contém toda a configuração do seu fluxo de trabalho. Para obter mais informações, consulte [Criar um documento de fluxo de trabalho do YAML](image-workflow-create-document.md).

O exemplo a seguir mostra como criar um fluxo de trabalho de compilação com o comando [create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) 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 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"
}
```

------