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á.
# Criação de AWS Support aplicativos nos recursos do Slack com AWS CloudFormation
AWS Support O aplicativo no Slack é integrado com AWS CloudFormation, um serviço que ajuda você a modelar e configurar seus AWS recursos para que você possa gastar menos tempo criando e gerenciando seus recursos e infraestrutura. Você cria um modelo que descreve todos os AWS recursos que você deseja (como o seu AccountAlias e SlackChannelConfiguration) e CloudFormation provisiona e configura esses recursos para você.
Ao usar CloudFormation, você pode reutilizar seu modelo para configurar os recursos do AWS Support aplicativo de forma consistente e repetida. Descreva seus recursos uma vez e, em seguida, provisione os mesmos recursos repetidamente em várias Contas da AWS regiões.
## AWS Support Aplicativo e CloudFormation modelos
Para provisionar e configurar recursos para AWS Support aplicativos e serviços relacionados, você deve entender [CloudFormation os modelos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/template-guide.html). Os modelos são arquivos de texto formatados em JSON ou YAML. Esses modelos descrevem os recursos que você deseja provisionar em suas CloudFormation pilhas. Se você não estiver familiarizado com JSON ou YAML, você pode usar o CloudFormation Designer para ajudá-lo a começar a usar modelos. CloudFormation Para obter mais informações, consulte [O que é CloudFormation Designer?](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/working-with-templates-cfn-designer.html) no *Guia do AWS CloudFormation usuário*.
AWS Support O aplicativo suporta a criação de seu AccountAlias e SlackChannelConfiguration em CloudFormation. Para obter mais informações, incluindo exemplos de modelos JSON e YAML para os SlackChannelConfiguration recursos AccountAlias e, consulte a [referência do tipo de recurso do AWS Support aplicativo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_SupportApp.html) no Guia do *AWS CloudFormation usuário*.
## Criar recursos de configuração do Slack para a organização
Você pode usar CloudFormation modelos para criar os recursos necessários para o AWS Support aplicativo. Se você for a conta de gerenciamento de sua organização, você poderá usar os modelos para criar esses recursos para suas contas-membro no AWS Organizations.
Por exemplo, você pode usar um modelo para criar a mesma configuração de espaço de trabalho do Slack para todas as contas na organização, mas depois usar modelos separados para criar diferentes configurações de canal do Slack para unidades específicas Contas da AWS ou organizacionais (). OUs Você também pode usar um modelo para criar uma configuração de espaço de trabalho do Slack para que as contas-membro possam configurar os canais do Slack que desejam para suas Contas da AWS.
Você pode escolher se quer usar CloudFormation modelos ou não. Se não usar modelos do CloudFormation , você poderá concluir as seguintes etapas manuais em vez disso:
+ Crie os recursos do AWS Support aplicativo no AWS Support Center Console.
+ Chame a operação da API [https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html](https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html) para registrar um espaço de trabalho do Slack para sua conta. A CloudFormation pilha chama essa operação de API para você.
+ Crie uma função do IAM com as permissões necessárias para cada conta de membro.
+ Chame a operação [https://docs.aws.amazon.com/supportapp/latest/APIReference/API_CreateSlackChannelConfiguration.html](https://docs.aws.amazon.com/supportapp/latest/APIReference/API_CreateSlackChannelConfiguration.html)da API para configurar um canal do Slack para cada conta de membro.
Para obter etapas manuais detalhadas, consulte[Autorizar várias contas](authorize-slack-workspace.md#authorize-multiple-accounts).
Siga estes procedimentos para carregar o CloudFormation modelo em sua organização. Você pode usar os modelos de exemplo da página de [referência dos tipos de recursos do AWS Support App](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_SupportApp.html).
Os modelos CloudFormation instruem a criação dos seguintes recursos:
+ Uma [configuração de canal do Slack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-supportapp-slackchannelconfiguration.html).
+ Uma [configuração de espaço de trabalho do Slack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-supportapp-slackworkspaceconfiguration.html).
+ Um [perfil do IAM](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iam-role.html) com o nome `AWSSupportSlackAppCFNRole`. A política AWSSupportAppFullAccess AWS gerenciada está anexada.
**Contents**
+ [Atualize seus CloudFormation modelos para o Slack](#update-the-templates-for-slack)
+ [Criar uma pilha para a conta de gerenciamento](#create-your-stack-for-slack)
+ [Criar um conjunto de pilhas para a organização](#create-your-stackset-for-your-organization)
### Atualize seus CloudFormation modelos para o Slack
Para começar, use os modelos a seguir para criar sua pilha. É necessário substituir os modelos por valores válidos para seu espaço de trabalho e canal do Slack.
**nota**
Não recomendamos usar o modelo para criar um recurso [AccountAlias](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-supportapp-accountalias.html) para sua organização. O AccountAlias recurso identifica exclusivamente um Conta da AWS no aplicativo. AWS Support Suas contas-membro podem inserir um nome de conta no console da central de suporte. Para obter mais informações, consulte [Autorizar um espaço de trabalho do Slack](authorize-slack-workspace.md).
**Para atualizar seus CloudFormation modelos para o Slack**
1. Se você for a conta de gerenciamento de uma organização, deverá autorizar manualmente um espaço de trabalho do Slack para sua conta antes que suas contas de membros possam usar CloudFormation para criar os recursos. Caso ainda não tenha feito isso, consulte [Autorizar um espaço de trabalho do Slack](authorize-slack-workspace.md).
1. Na página de [referência de tipos de recursos do AWS Support App](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/AWS_SupportApp.html), copie o modelo JSON ou YAML para o recurso que você deseja.
1. Em um editor de texto, cole o modelo em um novo arquivo.
1. No modelo, especifique os parâmetros desejados. No mínimo, substitua os valores destes campos:
+ `TeamId` por seu ID de espaço de trabalho do Slack
+ `ChannelId` pelo ID do canal Slack
+ `ChannelName` por um nome para identificar a configuração do canal do Slack
**dica**
Para encontrar o workspace e o canal IDs, abra seu canal do Slack em um navegador. No URL, seu ID do espaço de trabalho é o primeiro identificador e o ID do canal é o segundo. Por exemplo, em https://app.slack.com/client/T012ABCDEFG/C01234A5BCD, T012ABCDEFG é o ID do espaço de trabalho e C01234A5BCD é o ID do canal.
1. Salve o arquivo como JSON ou YAML.
### Criar uma pilha para a conta de gerenciamento
Em seguida, é necessário criar uma pilha para a conta de gerenciamento na organização. Essa etapa chama a operação de API [https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html](https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html) para você e autoriza o espaço de trabalho com o Slack.
**nota**
Recomendamos carregar o modelo de configuração do espaço de trabalho do Slack que você atualizou no procedimento anterior para a conta de gerenciamento. Você não precisa fazer o upload do modelo de configuração do canal Slack, a menos que também esteja configurando a conta de gerenciamento para usar o AWS Support aplicativo.
**Crie uma pilha para a conta de gerenciamento**
1. Faça login Console de gerenciamento da AWS como a conta de gerenciamento da sua organização.
1. Abra o CloudFormation console em [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Caso ainda não tenha feito isso, no **seletor de região**, escolha uma das seguintes opções: Regiões da AWS
+ Europa (Frankfurt)
+ Europa (Irlanda)
+ Europa (Londres)
+ Leste dos EUA (Norte da Virgínia)
+ Leste dos EUA (Ohio)
+ Oeste dos EUA (Oregon)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Tóquio)
+ Canadá (Central)
1. Siga o procedimento abaixo para criar uma pilha. Para obter mais informações, consulte [Criar uma pilha no console do CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html).
Depois de criar a pilha CloudFormation com sucesso, você pode usar o mesmo modelo para criar um conjunto de pilhas para sua organização.
### Criar um conjunto de pilhas para a organização
Em seguida, use o mesmo modelo para a configuração do espaço de trabalho do Slack para criar um conjunto de pilhas com permissões `service-managed`. Você pode usar conjuntos de pilhas para criar a pilha para toda a sua organização ou especificar a OUs que você deseja. Para obter mais informações, consulte [Criar um conjunto de pilhas](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html).
Esse procedimento também chama a operação de API [https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html](https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html) para você. Essa operação de API autoriza o espaço de trabalho com o Slack para as contas-membro.
**Para criar um conjunto de pilhas para a organização**
1. Faça login Console de gerenciamento da AWS como a conta de gerenciamento da sua organização.
1. Abra o CloudFormation console em [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).
1. Caso ainda não tenha feito isso, no **seletor de região**, escolha a mesma Região da AWS que você usou no procedimento anterior.
1. No painel de navegação, escolha **StackSets**.
1. Escolha **Criar StackSet**.
1. Na página **Choose a template** (Escolha um modelo), mantenha as opções padrão para as seguintes opções:
+ Em **Permissions** (Permissões), mantenha **Service-managed permissions** (Permissões gerenciadas pelo serviço).
+ Em **Prerequisite - Prepare template** (Pré-requisito: preparar modelo), mantenha **Template is ready** (O modelo está pronto).
1. Em **Specify template** (Especificar modelo), selecione **Upload a template file** (Carregar um arquivo de modelo) e depois **Choose file** (Escolher arquivo).
1. Escolha seu arquivo e escolha **Next** (Próximo).
1. Na página **Especificar StackSet detalhes**, insira um nome de pilha**support-app-slack-workspace**, como, insira uma descrição e escolha **Avançar**.
1. Na página **Configurar StackSet opções**, mantenha as opções padrão e escolha **Avançar**.
1. Na página **Set deployment options** (Definir opções de implantação), em **Add stacks to stack set** (Adicionar pilhas ao conjunto de pilhas), mantenha a opção padrão **Deploy new stacks** (Implantar novas pilhas).
1. Para **destinos de implantação**, escolha se você deseja criar a pilha para toda a organização ou para uma específica OUs. Se escolher uma UO, insira o ID da UO.
1. Em **Especificar regiões**, insira somente *uma* das seguintes opções Regiões da AWS:
+ Europa (Frankfurt)
+ Europa (Irlanda)
+ Europa (Londres)
+ Leste dos EUA (Norte da Virgínia)
+ Leste dos EUA (Ohio)
+ Oeste dos EUA (Oregon)
+ Ásia-Pacífico (Singapura)
+ Ásia-Pacífico (Tóquio)
+ Canadá (Central)
**Observações:**
Para simplificar seu fluxo de trabalho, recomendamos que você use o mesmo Região da AWS que escolheu na etapa 3.
Escolher mais de um Região da AWS pode causar conflitos na criação de sua pilha.
1. Para **opções de implantação**, para **Tolerância a falhas - opcional**, insira o número de contas em que as pilhas podem falhar antes de CloudFormation interromper a operação. Recomendamos inserir o número de contas que deseja adicionar, menos uma. Por exemplo, se sua UO especificada tiver dez contas-membro, insira 9. Isso significa que, mesmo que a operação CloudFormation falhe 9 vezes, pelo menos uma conta será bem-sucedida.
1. Escolha **Próximo**.
1. Na página **Review** (Revisar), reveja suas opções e escolha **Submit** (Enviar). É possível verificar o status de sua pilha na guia **Stack instances** (Instâncias da pilha).
1. (Opcional) Repita esse procedimento para carregar um modelo para a configuração de um canal do Slack. O modelo de exemplo também cria a função do IAM e anexa uma política AWS gerenciada. Essa função tem as permissões necessárias para acessar outros serviços por você. Para obter mais informações, consulte [Gerenciando o acesso ao AWS Support aplicativo](support-app-permissions.md).
Se você não criar um conjunto de pilhas para criar a configuração do canal do Slack, suas contas-membro poderão configurar manualmente o canal do Slack. Para obter mais informações, consulte [Como configurar um canal do Slack](add-your-slack-channel.md).
Depois de CloudFormation criar as pilhas, cada conta membro pode entrar no console do Support Center e encontrar seus espaços de trabalho e canais configurados do Slack. Eles podem então usar o AWS Support aplicativo para seus Conta da AWS. Consulte [Como criar casos de suporte em um canal do Slack](create-case-in-slack.md).
**dica**
Caso precise carregar um novo modelo, recomendamos usar a mesma Região da AWS especificada anteriormente.
## Saiba mais sobre CloudFormation
Para saber mais sobre isso CloudFormation, consulte os seguintes recursos:
+ [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+ [AWS CloudFormation Guia do usuário](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)
+ [CloudFormation API Reference](https://docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/Welcome.html)
+ [AWS CloudFormation Guia do usuário da interface de linha de comando](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/what-is-cloudformation-cli.html)
## Crie recursos de AWS Support aplicativos usando o Terraform
Você também pode usar o [Terraform](https://www.terraform.io/) para criar os recursos do AWS Support aplicativo para o seu Conta da AWS. O Terraform é uma infrastructure-as-code ferramenta que você pode usar para seus aplicativos em nuvem. Você pode usar o Terraform para criar recursos de AWS Support aplicativos em vez de implantar uma CloudFormation pilha em uma conta.
Depois de instalar o Terraform, você pode especificar os recursos do AWS Support aplicativo que deseja. O Terraform chama a operação de API [https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html](https://docs.aws.amazon.com/supportapp/latest/APIReference/API_RegisterSlackWorkspaceForOrganization.html) para registrar um espaço de trabalho do Slack para você e cria seus recursos. Em seguida, você pode fazer login no console da Central de suporte e encontrar seus espaços de trabalho e canais do Slack configurados.
**Observações**
Se você for a conta de gerenciamento de uma organização, é necessário autorizar manualmente um espaço de trabalho do Slack para sua conta antes que suas contas-membro possam usar o Terraform para criar os recursos. Caso ainda não tenha feito isso, consulte [Autorizar um espaço de trabalho do Slack](authorize-slack-workspace.md).
Ao contrário dos conjuntos de CloudFormation pilhas, você não pode usar o Terraform para criar os recursos do AWS Support aplicativo para uma OU em sua organização.
Você também encontra o histórico de eventos dessas atualizações no Terraform no AWS CloudTrail. O `eventSource` desses eventos será `cloudcontrolapi.amazonaws.com` e `supportapp.amazonaws.com`. Para obter mais informações, consulte [Registrando AWS Support o aplicativo em chamadas de API do Slack usando AWS CloudTrail](logging-using-cloudtrail-support-app.md).
### Saiba mais
Para saber mais sobre o Terraform, consulte os tópicos a seguir:
+ [Instalação do Terraform](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/install-cli)
+ [Tutorial do Terraform: Crie infraestrutura para AWS](https://developer.hashicorp.com/terraform/tutorials/aws-get-started/aws-build)
+ `[awscc\_support\_app\_account\_alias](https://registry.terraform.io/providers/hashicorp/awscc/latest/docs/resources/supportapp_account_alias)`
+ `[awscc\_supportapp\_slack\_workspace\_configuration](https://registry.terraform.io/providers/hashicorp/awscc/latest/docs/resources/supportapp_slack_workspace_configuration)`
+ `[awscc\_supportapp\_slack\_channel\_configuration](https://registry.terraform.io/providers/hashicorp/awscc/latest/docs/resources/supportapp_slack_channel_configuration)`