Criação de AWS Support aplicativos nos recursos do Slack com AWS CloudFormation - AWS Support

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 AWS CloudFormation provisiona e configura esses recursos para você.

Ao usar AWS 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 AWS CloudFormation modelos

Para provisionar e configurar recursos para AWS Support aplicativos e serviços relacionados, você deve entender AWS CloudFormation os modelos. Os modelos são arquivos de texto formatados em JSON ouYAML. Esses modelos descrevem os recursos que você deseja provisionar em suas AWS CloudFormation pilhas. Se você não estiver familiarizado com JSON ouYAML, você pode usar o AWS CloudFormation Designer para ajudá-lo a começar a usar AWS CloudFormation modelos. Para obter mais informações, consulte O que é AWS CloudFormation Designer? no Guia do AWS CloudFormation usuário.

AWS Support O aplicativo suporta a criação de seu AccountAlias e SlackChannelConfiguration em AWS CloudFormation. Para obter mais informações, incluindo exemplos JSON e YAML modelos para os SlackChannelConfiguration recursos AccountAlias e, consulte a referência do tipo de recurso do AWS Support aplicativo 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 você não usa CloudFormation modelos, em vez disso, pode concluir as seguintes etapas manuais:

  • Crie os recursos do AWS Support aplicativo no AWS Support Center Console.

  • Crie um caso de suporte AWS Support para autorizar várias contas a usar o AWS Support aplicativo.

  • Ligue para o RegisterSlackWorkspaceForOrganizationAPIoperação para registrar um espaço de trabalho do Slack para sua conta. A CloudFormation pilha chama essa API operação para você.

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.

Os modelos CloudFormation instruem a criação dos seguintes recursos:

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 o uso do modelo para criar um AccountAlias recurso para sua organização. A ferramenta AccountAlias Um recurso identifica de forma exclusiva 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.

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.

  2. Na página de referência do tipo de recurso do AWS Support aplicativo, copie o YAML modelo JSON ou para o recurso que você deseja.

  3. Em um editor de texto, cole o modelo em um novo arquivo.

  4. 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 canalIDs, abra seu canal do Slack em um navegador. NoURL, seu ID do workspace é o primeiro identificador e o ID do canal é o segundo. Por exemplo, em https://app.slack.com/client/T012ABCDEFG/C01234A5BCD, T012 ABCDEFG é o ID do espaço de trabalho e BCD C01234A5 é o ID do canal.

  5. Salve o arquivo como YAML arquivo JSON ou.

Criar uma pilha para a conta de gerenciamento

Em seguida, é necessário criar uma pilha para a conta de gerenciamento na organização. Esta etapa chama o RegisterSlackWorkspaceForOrganizationAPIoperação 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 AWS Management Console como a conta de gerenciamento da sua organização.

  2. Abra o AWS CloudFormation console em https://console.aws.amazon.com/cloudformation.

  3. 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)

  4. Siga o procedimento abaixo para criar uma pilha. Para obter mais informações, consulte Criar uma pilha no console do AWS CloudFormation.

    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.

Esse procedimento também chama o RegisterSlackWorkspaceForOrganizationAPIoperação para você. Essa API operação autoriza o espaço de trabalho com o Slack para as contas dos membros.

Para criar um conjunto de pilhas para a organização
  1. Faça login AWS Management Console como a conta de gerenciamento da sua organização.

  2. Abra o AWS CloudFormation console em https://console.aws.amazon.com/cloudformation.

  3. Se ainda não o fez, no seletor de região, escolha o mesmo Região da AWS que você usou no procedimento anterior.

  4. No painel de navegação, escolha StackSets.

  5. Escolha Criar StackSet.

  6. 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).

  7. Em Specify template (Especificar modelo), selecione Upload a template file (Carregar um arquivo de modelo) e depois Choose file (Escolher arquivo).

  8. Escolha seu arquivo e escolha Next (Próximo).

  9. Na página Especificar StackSet detalhes, insira um nome de pilhasupport-app-slack-workspace, como, insira uma descrição e escolha Avançar.

  10. Na página Configurar StackSet opções, mantenha as opções padrão e escolha Avançar.

  11. 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).

  12. Para destinos de implantação, escolha se você deseja criar a pilha para toda a organização ou para uma específicaOUs. Se escolher uma UO, insira o ID da UO.

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

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

  15. Escolha Próximo.

  16. 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).

  17. (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 IAM função 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 Como gerenciar o acesso ao aplicativo AWS Support.

    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.

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.

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:

Crie recursos de AWS Support aplicativos usando o Terraform

Você também pode usar o Terraform 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 o RegisterSlackWorkspaceForOrganizationAPIoperação para registrar um espaço de trabalho do Slack para você e criar 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.

  • 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 AWS Support Aplicativo de registro em API chamadas do Slack usando AWS CloudTrail.

Saiba mais

Para saber mais sobre o Terraform, consulte os tópicos a seguir: