Ativar uma extensão pública de terceiros em sua conta

Para ativar uma extensão pública para uso em sua conta

1. Faça login no AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

2. Na barra de navegação na parte superior da tela, escolha sua Região da AWS.

3. No painel de navegação, em Registro, selecione Extensões públicas.

4. Use a opção Filtrar para selecionar o tipo de extensão e selecione Terceiros. (Extensões publicadas pela AWS são ativadas por padrão.)

5. Selecione a extensão e depois Ativar.

   Se várias versões de uma extensão estiverem disponíveis, você poderá usar o menu Versão para selecionar a versão da extensão que deseja ativar. A versão padrão é a mais atual.

6. Para Nome da extensão, você pode manter a opção Usar padrão selecionada ou escolher Substituir padrão e inserir o alias do tipo de extensão que deseja usar com essa extensão. O alias deve seguir o formato recomendado para o tipo de extensão. Para ter mais informações, consulte Usar aliases para fazer referência a extensões.

7. Se a extensão que você está ativando for um hook ou um tipo de recurso, para ARN do perfil de execução, especifique o perfil do IAM que o CloudFormation deve assumir ao invocar a extensão. Para ter mais informações, consulte Configure um perfil de execução com permissões do IAM e uma política de confiança para acesso público à extensão.

8. Em Configuração do registro em log, se desejar, especifique as informações de configuração de registro em log para uma extensão. Por exemplo:

   {
       "logRoleArn": "arn:aws:iam::account:role/rolename",
       "logGroupName": "log-group-name"
   }

   As informações de configuração de registro em log não são necessárias, mas são recomendadas para fins de depuração. Para utilizar a configuração de registro em log com hooks, adicione a mesma política de confiança que a função de execução especificada, para que a função de registro em log possa gravar logs no seu grupo de logs.

   Os nomes de chaves logRoleArn e logGroupName diferenciam maiúsculas de minúsculas.

9. Em Versionamento, Atualizações automáticas, escolha como as atualizações serão recebidas.

   • On (Ativado): atualiza automaticamente para a versão secundária mais recente. As versões principais são atualizadas manualmente.

   • Off (Desativado): nunca atualiza automaticamente para a versão mais recente. Todas as versões são atualizadas manualmente.

   Para ter mais informações, consulte Usar novas versões de extensões automaticamente.

Para especificar os dados de configuração.

1. Em Configuração, escolha Configurar agora e, em seguida, escolha Ativar extensão.

   O CloudFormation exibe a página Configure extension (Configurar extensão). Para visualizar o esquema de configuração atual da extensão, certifique-se de a opção View configuration schema (Visualizar esquema de configuração) esteja ativada.

2. Na caixa de texto Configuration JSON (Configuração JSON), insira uma string JSON que represente os dados de configuração que você deseja especificar para essa extensão. O JSON especificado deve ser válido em relação ao esquema de configuração da extensão.

3. Escolha Configurar extensão.

1. Em Configuração, escolha Configurar mais tarde e, em seguida, escolha Ativar extensão.

2. Depois que a extensão for ativada, você poderá configurá-la navegando até a extensão na página de extensões ativadas e fornecendo os dados de configuração.

Para ativar um hook público para uso em sua conta (AWS CLI)

1. Obtenha o ARN para do hook e salve-o. Você pode obter o ARN de um Hook usando o AWS Management Console ou a AWS CLI. Para ter mais informações, consulte Visualizar as extensões disponíveis e ativadas no registro do CloudFormation.

   export HOOK_TYPE_ARN="arn:aws:cloudformation:us-west-2:123456789012:type/hook/Organization-Service-Hook/"

2. Use o comando set-type-configuration para especificar os dados de configuração. O JSON transmitido por você para --configuration deverá ser válido em relação ao esquema de configuração do hook. Para ativar o hook para todas as operações de pilha, é necessário definir a propriedade HookInvocationStatus como ENABLED na seção HookConfiguration.

   aws cloudformation set-type-configuration \
     --configuration "{"CloudFormationConfiguration":{"HookConfiguration":{"HookInvocationStatus": "ENABLED", "FailureMode": "FAIL", "Properties":{}}}}" \
     --type-arn $HOOK_TYPE_ARN --region us-west-2

   Para obter mais informações sobre as opções de configuração de HookConfiguration, consulte Hook configuration schema syntax reference no AWS CloudFormation Hooks User Guide.

Para ativar uma extensão pública para uso em sua conta (AWS CLI)

• Use activate-type para ativar a extensão e especificar se ela deve ser atualizada automaticamente sempre que uma nova versão secundária for publicada.

  O exemplo abaixo especifica o nome do recurso da Amazon (ARN) público de uma extensão pública a ser ativada para essa conta. Além disso, ele especifica que o CloudFormation deve atualizar a extensão sempre que uma nova versão secundária é publicada.

  aws cloudformation activate-type \
    --public-type-arn public_extension_ARN \
    --execution-role arn:aws:iam::123456789012:role/my-execution-role \
    --auto-update true --region us-west-2

  Esse comando retorna um ARN da extensão ativada.

  {
      "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Resource-Example"
  }