Trabalhando com tipos de alteração de provisionamento () CTs - Guia do desenvolvedor de aplicativos avançados do AMS

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

Trabalhando com tipos de alteração de provisionamento () CTs

O AMS é responsável por sua infraestrutura gerenciada. Para fazer alterações, você deve enviar uma RFC com a classificação CT correta (categoria, subcategoria, item e operação). Esta seção descreve como encontrar CTs, determinar se alguma é adequada às suas necessidades e solicitar uma nova tomografia computadorizada, se nenhuma for.

Veja se uma tomografia computadorizada existente atende aos seus requisitos

Depois de determinar o que você deseja implantar com o AMS, a próxima etapa é estudar o existente CTs e os CloudFormation modelos para ver se já existe uma solução.

Ao criar um RFC, você deve especificar o CT. Você pode usar a Console de gerenciamento da AWS API/CLI do AMS. Exemplos de uso de ambos são descritos a seguir.

Você pode usar o console ou o API/CLI para encontrar uma ID de tipo de alteração (CT) ou versão. Existem dois métodos: pesquisar ou escolher a classificação. Para ambos os tipos de seleção, você pode classificar a pesquisa escolhendo Usado com mais frequência, Usado mais recentemente ou Alfabético.

YouTube Vídeo: Como faço para criar uma RFC usando a CLI do AWS Managed Services e onde posso encontrar o esquema de CT?

No console do AMS, na página RFCs-> Criar RFC:

  • Com a opção Procurar por tipo de alteração selecionada (o padrão), você pode:

    • Use a área de criação rápida para selecionar entre as mais populares do AMS CTs. Clique em um rótulo e a página Executar RFC será aberta com a opção Assunto preenchida automaticamente para você. Preencha as opções restantes conforme necessário e clique em Executar para enviar a RFC.

    • Ou desça até a área Todos os tipos de alteração e comece a digitar um nome de CT na caixa de opções, você não precisa ter o nome exato ou completo do tipo de alteração. Você também pode pesquisar uma tomografia computadorizada por ID do tipo de alteração, classificação ou modo de execução (automático ou manual) inserindo as palavras relevantes.

      Com a visualização padrão dos cartões selecionada, os cartões CT correspondentes aparecem conforme você digita, seleciona um cartão e clica em Criar RFC. Com a exibição da tabela selecionada, escolha o CT relevante e clique em Criar RFC. Ambos os métodos abrem a página Executar RFC.

  • Como alternativa, e para explorar as opções de tipo de alteração, clique em Escolher por categoria na parte superior da página para abrir uma série de caixas de opções suspensas.

  • Escolha uma categoria, uma subcategoria, um item e uma operação. A caixa de informações desse tipo de alteração aparece e um painel aparece na parte inferior da página.

  • Quando estiver pronto, pressione Enter e uma lista dos tipos de alteração correspondentes será exibida.

  • Escolha um tipo de alteração na lista. A caixa de informações desse tipo de alteração aparece na parte inferior da página.

  • Depois de ter o tipo de alteração correto, escolha Criar RFC.

nota

A CLI do AMS deve estar instalada para que esses comandos funcionem. Para instalar a API ou a CLI do AMS, acesse a página Recursos para desenvolvedores do console AMS. Para obter material de referência sobre a API AMS CM ou a API AMS SKMS, consulte a seção Recursos de informação do AMS no Guia do usuário. Talvez seja necessário adicionar uma --profile opção para autenticação; por exemplo,aws amsskms ams-cli-command --profile SAML. Talvez você também precise adicionar a --region opção, pois todos os comandos do AMS saem de us-east-1; por exemplo. aws amscm ams-cli-command --region=us-east-1

nota

Os endpoints AMS API/CLI (amscm e amsskms) estão na região da AWS Norte da Virgínia,. us-east-1 Dependendo de como sua autenticação está configurada e em qual região da AWS sua conta e seus recursos estão, talvez seja necessário adicioná-la --region us-east-1 ao emitir comandos. Talvez você também precise adicionar--profile saml, se esse for o seu método de autenticação.

Para pesquisar um tipo de alteração usando a API AMS CM (consulte ListChangeTypeClassificationSummaries) ou a CLI:

Você pode usar um filtro ou uma consulta para pesquisar. A ListChangeTypeClassificationSummaries operação tem opções de filtros para CategorySubcategory,Item, eOperation, mas os valores devem corresponder exatamente aos valores existentes. Para obter resultados mais flexíveis ao usar a CLI, você pode usar a --query opção.

Altere a filtragem de tipo com a API/CLI do AMS CM
Atributo Valores válidos Condição válida/padrão Observações

ChangeTypeId

Qualquer string representando um ChangeTypeId (por exemplo: ct-abc123xyz7890)

Igual

Para o tipo de alteração IDs, consulte a Referência do tipo de alteração.

Para o tipo de alteração IDs, consulte Encontrando um tipo de alteração ou CSIO.

Categoria

Qualquer texto de formato livre

Contém

Expressões regulares em cada campo individual não são suportadas. Pesquisa sem distinção entre maiúsculas e min

Subcategory

Item

Operação

  1. Aqui estão alguns exemplos de classificações de tipo de alteração de listagem:

    O comando a seguir lista todas as categorias de tipo de alteração.

    aws amscm list-change-type-categories

    O comando a seguir lista as subcategorias pertencentes a uma categoria especificada.

    aws amscm list-change-type-subcategories --category CATEGORY

    O comando a seguir lista os itens pertencentes a uma categoria e subcategoria especificadas.

    aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY
  2. Aqui estão alguns exemplos de pesquisa de tipos de alteração com consultas CLI:

    O comando a seguir pesquisa resumos de classificação de CT para aqueles que contêm “S3" no nome do item e cria a saída da categoria, subcategoria, item, operação e ID do tipo de alteração em forma de tabela.

    aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
    +---------------------------------------------------------------+ | ListChangeTypeClassificationSummaries | +----------+-------------------------+--+------+----------------+ |Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r| +----------+-------------------------+--+------+----------------+
  3. Em seguida, você pode usar o ID do tipo de alteração para obter o esquema de CT e examinar os parâmetros. O comando a seguir gera o esquema em um arquivo JSON chamado Creates3Params.schema.json.

    aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json

    Para obter informações sobre o uso de consultas CLI, consulte Como filtrar a saída com a opção --query e a referência da linguagem de consulta, Especificação. JMESPath

  4. Depois de ter o ID do tipo de alteração, recomendamos verificar a versão do tipo de alteração para garantir que seja a versão mais recente. Use esse comando para encontrar a versão de um tipo de alteração especificado:

    aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID

    Para encontrar o AutomationStatus para um tipo de alteração específico, execute este comando:

    aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"

    Para encontrar o ExpectedExecutionDurationInMinutes para um tipo de alteração específico, execute este comando:

    aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"

Depois de encontrar uma CT que considere apropriada, examine os parâmetros de execução do esquema JSON associados a ela para saber se ela aborda seu caso de uso.

Use esse comando para gerar um esquema CT em um arquivo JSON com o nome do CT; este exemplo gera o esquema de armazenamento Create S3:

aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateBucketParams.json

Vamos dar uma olhada mais de perto no que esse esquema oferece.

Esquema de criação do S3 Bucket
{ "$schema": "http://json-schema.org/draft-04/schema#", "name": "Create S3 Storage "description": "Use to create an Amazon Simple Storage Service stack.", "type": "object", "properties": { "Description": { "description": "The description of the stack.", "type": "string", "minLength": 1, "maxLength": 500 }, "VpcId": { "description": "ID of the VPC to create the S3 Bucket in, in the form vpc-a1b2c3d4e5f67890e.", "type": "string", "pattern": "^vpc-[a-z0-9]{17}$" }, "StackTemplateId": { "description": "Required value: stm-s2b72beb000000000.", "type": "string", "enum": ["stm-s2b72beb000000000"] }, "Name":{ "description": "The name of the stack to create.", "type": "string", "minLength": 1, "maxLength": 255 }, "Tags": { "description": "Up to seven tags (key/value pairs) for the stack.", "type": "array", "items": { "type": "object", "properties": { "Key": { "type": "string", "minLength": 1, "maxLength": 127 }, "Value": { "type": "string", "minLength": 1, "maxLength": 255 } }, "additionalProperties": false, "required": [ "Key", "Value" ] }, "minItems": 1, "maxItems": 7 }, "TimeoutInMinutes": { "description": "The amount of time, in minutes, to allow for creation of the stack.", "type": "number", "minimum": 0, "maximum": 60 }, "Parameters": { "description": "Specifications for the stack.", "type": "object", "properties": { "AccessControl": { "description": "The canned (predefined) access control list (ACL) to assign to the bucket.", "type": "string", "enum": [ "Private", "PublicRead", "AuthenticatedRead", "BucketOwnerRead" ] }, "BucketName": { "description": "A name for the bucket. The bucket name must contain only lowercase letters, numbers, periods (.), and hyphens (-).", "type": "string", "pattern": "^[a-z0-9]([-.a-z0-9]+)[a-z0-9]$", "minLength": 3, "maxLength": 63 } }, "additionalProperties": false, "required": [ "AccessControl", "BucketName" ] } }, "additionalProperties": false, "required": [ "Description", "VpcId", "StackTemplateId", "Name", "TimeoutInMinutes", "Parameters" ] }

O esquema começa com a CT (“descrição”), que informa para que serve o esquema. Nesse caso, para criar uma pilha de armazenamento S3.

Em seguida, você tem propriedades obrigatórias e opcionais que você pode especificar. Os valores padrão das propriedades são fornecidos. As propriedades obrigatórias estão listadas no final do esquema.

Na StackTemplateId área, você vê que há um modelo de pilha específico para esse CT e esquema, e seu ID é um valor de propriedade obrigatório.

O esquema permite marcar a pilha que você está criando, para fins de contabilidade interna. Além disso, algumas opções, como backup, exigem uma tag de key:BACKUP e value:TRUE. Para obter informações detalhadas, leia Como marcar seus recursos da Amazon EC2 .

A seção Parâmetros do esquema CT JSON é onde você fornece os parâmetros de execução.

Para esse esquema, somente a ACL e os parâmetros de execução BucketName são obrigatórios.

Solicite um novo CT

Depois de examinar o esquema, você pode decidir que ele não fornece parâmetros suficientes para criar a implantação desejada. Se for esse o caso, examine os CloudFormation modelos existentes para encontrar um que seja mais próximo do que você deseja. Depois de saber quais parâmetros adicionais você precisa, envie um Management | Other | Other | Create CT.

nota

Todos os outros | Outros Create and Update CTs recebem a atenção de um operador de AMS, que entrará em contato com você para discutir o novo CT.

Para enviar uma solicitação para um novo CT, acesse o console do AMS por meio do console normal Console de gerenciamento da AWSe siga estas etapas.

  1. Na navegação à esquerda, clique em RFCs.

    A página RFCs do painel é aberta.

  2. Clique em Criar.

    A página Criar uma solicitação de alteração é aberta.

  3. Selecione Gerenciamento na lista suspensa Categoria e Outro para Subcategoria e Item. Para a Operação, escolha Criar. O RFC precisará de aprovação antes de ser implementado.

  4. Insira as informações do motivo pelo qual você deseja a CT, por exemplo: Solicitando uma CT de armazenamento Create S3 modificada que permita a personalização ACLs, com base na CT de armazenamento Create S3 existente. Isso deve resultar em uma nova CT: Implantação | Componentes avançados de pilha | Armazenamento S3 | Criar ACL personalizada do S3. Essa nova tomografia computadorizada pode ser pública.

  5. Clique em Enviar.

    Seu RFC é exibido no painel do RFC.

Teste o novo CT

Depois que o AWS Managed Services criar essa nova CT, você a testa enviando uma RFC com ela. Se você trabalhou com o AMS para pré-aprovar o novo CT, basta seguir um envio padrão de RFC e observar o resultado (para obter detalhes sobre o envio RFCs, consulte Criação e envio de um RFC). Se a nova CT não for pré-aprovada (você quer ter certeza de que ela nunca será executada sem aprovação explícita), você precisará discutir sua implementação com o AMS sempre que quiser executá-la.