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

# Marcar instâncias para grupos de implantação em CodeDeploy
<a name="instances-tagging"></a>

Para ajudar a gerenciar as instâncias do Amazon EC2 e instâncias on-premises, você pode usar tags para atribuir seus próprios metadados a cada recurso. As tags permitem categorizar suas instâncias de diferentes formas (como por finalidade, por proprietário ou por ambiente). Isso é útil quando você tem várias instâncias. Você pode identificar rapidamente uma instância ou grupo de instâncias com base nas tags que você tiver atribuído a elas. Cada tag consiste de uma chave e um valor opcional, que podem ser definidos. Para obter mais informações, consulte [Marcar recursos do Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Using_Tags.html).

Para especificar quais instâncias estão incluídas em um grupo de CodeDeploy implantação, você especifica tags em um ou mais *grupos de tags*. As instâncias que atendem aos critérios de tag são aquelas nas quais a revisão de aplicativo mais recente esteja instalada quando uma implantação para o grupo de implementação for criado

**nota**  
Você também pode incluir grupos do Amazon EC2 Auto Scaling em grupos de implantação, mas eles são identificados por seus nomes em vez de tags aplicadas a instâncias. Para mais informações, consulte [Integração CodeDeploy com o Amazon EC2 Auto Scaling](integrations-aws-auto-scaling.md).

Os critérios para instâncias em um grupo de implementação podem ser tão simples quanto uma única tag em um único grupo de tags. Pode ser tão complexo como 10 tags, cada uma em um máximo de três grupos de tags.

Se você usar um grupo de tag única, qualquer instância identificada por pelo menos uma tag no grupo é incluída no grupo de implementação. Se você usar grupos de várias tags, apenas as instâncias que são identificadas por pelo menos uma tag em *cada* um dos grupos de tags serão incluídas.

Os exemplos a seguir ilustram como tags e grupos de tags podem ser usados para selecionar as instâncias de um grupo de implantação.

**Topics**
+ [Exemplo 1: Grupo de tag única, tag única](#instances-tagging-example-1)
+ [Exemplo 2: Grupo de tag única, várias tags](#instances-tagging-example-2)
+ [Exemplo 3: Grupos de várias tags, tags únicas](#instances-tagging-example-3)
+ [Exemplo 4: Grupos de várias tags, várias tags](#instances-tagging-example-4)

## Exemplo 1: Grupo de tag única, tag única
<a name="instances-tagging-example-1"></a>

Você pode especificar uma tag única em um grupo de tag única: 


**Grupo de tags 1**  

| Chave | Valor | 
| --- | --- | 
| Nome | AppVersion-ABC | 

Cada instância marcada com `Name=AppVersion-ABC` faz parte do grupo de implantação, mesmo se tiver outras tags aplicadas. 

CodeDeploy visualização da configuração do console: 

![\[O CodeDeploy console mostrando um grupo de tags com uma tag.\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/images/TaggingExample1-polaris.png)


Estrutura do JSON:

```
"ec2TagSet": { 
         "ec2TagSetList": [ 
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Name",
                  "Value": "AppVersion-ABC"
               }
            ]
         ]
      },
```

## Exemplo 2: Grupo de tag única, várias tags
<a name="instances-tagging-example-2"></a>

Você também pode especificar várias tags em um grupo de tag única:


**Grupo de tags 1**  

| Chave | Valor | 
| --- | --- | 
| Região | Norte | 
| Região | Sul | 
| Região | Leste | 

Uma instância marcada com qualquer dessas três tags faz parte do grupo de implantação, mesmo se tiver outras tags aplicadas. Se, por exemplo, você tiver outras instâncias com `Region=West`, elas não seriam incluídas no grupo de implantação.

CodeDeploy visualização da configuração do console: 

![\[O CodeDeploy console mostrando um grupo de tags com três tags.\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/images/TaggingExample2-polaris.png)


Estrutura do JSON:

```
"ec2TagSet": { 
         "ec2TagSetList": [ 
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Region",
                  "Value": "North"
               },
                              { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Region",
                  "Value": "South"
               },
                              { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Region",
                  "Value": "East"
               }
            ]
         ]
      },
```

## Exemplo 3: Grupos de várias tags, tags únicas
<a name="instances-tagging-example-3"></a>

Você também pode usar vários conjuntos de grupos de tags com um par de chave/valor único em cada para especificar os critérios para instâncias em um grupo de implantação. Quando você usa grupos de várias tags em um grupo de implantação, apenas as instâncias que são identificadas por todos os grupos de tags são incluídas no grupo de implantação. 


**Grupo de tags 1**  

| Chave | Valor | 
| --- | --- | 
| Nome | AppVersion-ABC | 


**Grupo de tags 2**  

| Chave | Valor | 
| --- | --- | 
| Região | Norte | 


**Grupo de tags 3**  

| Chave | Valor | 
| --- | --- | 
| Tipo | t2.medium | 

Você pode ter instâncias em várias regiões e de vários tipos de instância marcados com `Name=AppVersion-ABC`. Neste exemplo, somente as instâncias também marcadas com `Region=North` e `Type=t2.medium` fazem parte do grupo de implantação. 

CodeDeploy visualização da configuração do console: 

![\[O CodeDeploy console mostra três grupos de tags com uma tag em cada um.\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/images/TaggingExample3-polaris.png)


Estrutura do JSON:

```
"ec2TagSet": { 
         "ec2TagSetList": [ 
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Name",
                  "Value": "AppVersion-ABC"
               }
            ],
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Region",
                  "Value": "North"
               }
            ],
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Type",
                  "Value": "t2.medium"
               }
            ],
         ]
      },
```

## Exemplo 4: Grupos de várias tags, várias tags
<a name="instances-tagging-example-4"></a>

Quando você usa vários grupos de tags com várias tags em um ou mais grupos, uma instância deve corresponder a pelo menos uma das tags em cada um dos grupos.


**Grupo de tags 1**  

| Chave | Valor | 
| --- | --- | 
| Environment | Beta | 
| Environment | Preparação | 


**Grupo de tags 2**  

| Chave | Valor | 
| --- | --- | 
| Região | Norte | 
| Região | Sul | 
| Região | Leste | 


**Grupo de tags 3**  

| Chave | Valor | 
| --- | --- | 
| Tipo | t2.medium | 
| Tipo | t2.large | 

Neste exemplo, uma instância a ser incluída no grupo de implantação deve ser marcada com (1) `Environment=Beta` ou `Environment=Staging`, com (2) `Region=North`, `Region=South`ou `Region=East` e com (3) `Type=t2.medium` ou `Type=t2.large`.

Para ilustrar, instâncias com os seguintes grupos de tags *estariam* entre as inclusas no grupo de implantação:
+ `Environment=Beta`, `Region=North`,`Type=t2.medium`
+ `Environment=Staging`,`Region=East`,`Type=t2.large`
+ `Environment=Staging`,`Region=South`,`Type=t2.large`

Instâncias com os seguintes grupos de tags *não* estariam inclusas no grupo de implantação: Os valores de chave **destacados** fazem com que as instâncias sejam excluídas:
+ `Environment=Beta`, Region=**West**,`Type=t2.medium`
+ `Environment=Staging`,`Region=East`,Type=**t2.micro**
+ Environment=**Production**,`Region=South`,`Type=t2.large`

CodeDeploy visualização da configuração do console: 

![\[O CodeDeploy console mostra três grupos de tags com várias tags em cada um.\]](http://docs.aws.amazon.com/pt_br/codedeploy/latest/userguide/images/TaggingExample4-polaris.png)


Estrutura do JSON:

```
"ec2TagSet": { 
         "ec2TagSetList": [ 
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Environment",
                  "Value": "Beta"
               },
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Environment",
                  "Value": "Staging"
               }
            ],
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Region",
                  "Value": "North"
               },
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Region",
                  "Value": "South"
               },
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Region",
                  "Value": "East"
               }
            ],
            [ 
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Type",
                  "Value": "t2.medium"
               },
               { 
                  "Type": "KEY_AND_VALUE",
                  "Key": "Type",
                  "Value": "t2.large"
               }
            ],
         ]
      },
```