Como administrador de nuvem, você pode usar o auxiliar de alocação de nomenclatura personalizado para gerar nomes personalizados para seus recursos no Automation Assembler. Você pode usar o auxiliar de alocação de nomenclatura personalizado com qualquer tipo de recurso.

Depois de definir modelos de nomenclatura personalizados no Automation Assembler, você pode usar o auxiliar de alocação de nomenclatura personalizada para fazer referência aos modelos de nomenclatura personalizados na tela de Design. Consulte Nomenclatura de recursos personalizada para obter mais informações.

Esses casos de uso demonstram como usar o auxiliar de alocação de nomenclatura personalizado com o tipo de recurso Genérico e o tipo de recurso Máquina. O tipo de recurso Genérico abrange todos os recursos possíveis e está vinculado exclusivamente ao auxiliar de alocação de nomenclatura personalizado.

Observação:

Ao criar um modelo de nomenclatura personalizado com o tipo de recurso Genérico, você deve usar o auxiliar de alocação de nomenclatura personalizado para gerar um nome personalizado para o seu recurso. Se você não adicionar o auxiliar de alocação, um nome não será gerado para o recurso.

Consulte Designs baseados em plug-in e implantações do Automation Assembler para obter mais informações sobre alocação e auxiliares de alocação.

Antes de começar

Você deve configurar uma conta de nuvem e criar sua infraestrutura de recursos antes de poder usar auxiliares de alocação. Consulte Adição de contas de nuvem e Criação da infraestrutura de recursos para obter mais informações.

Criar um modelo de nomenclatura genérico

Você deve criar um modelo de nomenclatura personalizado para usar o auxiliar de alocação de nomenclatura personalizado. Nesse exemplo, você cria um modelo de nomenclatura Genérico, no nível da organização para suas implantações. Modelos de nomenclatura no nível da organização são aplicados a todas as implantações por padrão.

Você também pode criar modelos de nomenclatura no nível do projeto. Consulte Nomenclatura de recursos personalizada para obter mais informações.

Para criar um modelo de nomenclatura no nível da organização:

  1. Selecione Infraestrutura > Administração > Nomes Personalizados e clique em Novo Nome Personalizado.
  2. Insira um nome e uma descrição para o modelo de nomenclatura personalizado.
  3. Selecione Organização como o escopo.
  4. Clique Novo Modelo de Nomenclatura e configure as seguintes opções.
    Opção Valor
    Tipo de recurso Genérico
    Nome do modelo modelo my-custom

    O nome do modelo é uma cadeia de caracteres definida pelo usuário e serve como um identificador para o modelo especificado.

    O nome do modelo deverá ser especificado se o tipo de recurso for Genérico.

    Se você escolher Máquina como o tipo de recurso, não será necessário fazer referência ao nome do modelo, pois só é possível criar um modelo do tipo Máquina por projeto.
    Formato do modelo resource-${#####}
    Valor de contador inicial 1
    Etapa de incremento 1

    Com essa configuração, as implantações nos projetos atribuídos aumentarão a partir desse ponto de partida.

    Neste exemplo, em que o contador de início é 1 e o incremento é 1, a primeira implantação é numerada como 2. Se você precisar que a implantação seja iniciada em 1, defina o contador de início como zero e a etapa de incremento como 1.
  5. Clique em Adicionar.
  6. Se necessário, adicione modelos de nomenclatura personalizados adicionais.
  7. Clique em Criar.

As seções a seguir contêm alguns exemplos de modelo que usam o auxiliar de alocação de nomenclatura personalizado.

Provisionar um recurso com um modelo genérico

O modelo de nuvem a seguir mostra como usar um modelo do tipo Genérico para gerar um nome para uma instância do AWS EC2 baseada em plug-in. Nesse exemplo, você deve consultar o nome do modelo, my-custom-template.

formatVersion: 1
inputs: {}
resources:
  Allocations_CustomNaming_1:
    type: Allocations.CustomNaming
    properties:
      resourceType: Generic 
      templateName: my-custom-template
      numberOfNamesToGenerate: 1
  Idem_AWS_EC2_INSTANCE_2:
    type: Idem.AWS.EC2.INSTANCE
    properties:
      name: ${resource.Allocations_CustomNaming_1.selectedNames[0]} # an array of generated custom names
      region: us-west-2
      account: aws
      availability_zone: us-west-2b
      image_id: ami-022e8df2148a65830
      instance_type: t2.nano

Provisionar um recurso com um modelo de máquina

O modelo a seguir mostra como você pode usar um modelo do tipo Máquina para gerar uma nomenclatura personalizada para uma instância do AWS EC2. Você não precisa especificar o nome do modelo porque só pode criar um modelo de máquina por projeto.

formatVersion: 1
inputs: {}
resources:
  Allocations_CustomNaming_1:
    type: Allocations.CustomNaming
    properties:
      resourceType: Machine
      numberOfNamesToGenerate: 1
  Idem_AWS_EC2_INSTANCE_2:
    type: Idem.AWS.EC2.INSTANCE
    properties:
      name: ${resource.Allocations_CustomNaming_1.selectedNames[0]}
      region: us-west-2
      account: aws
      availability_zone: us-west-2b
      image_id: ami-022e8df2148a65830
      instance_type: t2.nano

Provisionar vários recursos com um modelo de máquina

O modelo a seguir mostra como você pode usar um modelo do tipo Máquina para gerar nomes para várias instâncias do AWS EC2. Você não precisa especificar o nome do modelo porque só pode criar um modelo de máquina por projeto.

formatVersion: 1
inputs: {}
resources:
  Allocations_CustomNaming_1:
    type: Allocations.CustomNaming
    properties:
      resourceType: Machine
      numberOfNamesToGenerate: 2
  Idem_AWS_EC2_INSTANCE_1:
    type: Idem.AWS.EC2.INSTANCE
    properties:
      name: ${resource.Allocations_CustomNaming_1.selectedNames[0]}
      region: us-west-2
      account: aws
      availability_zone: us-west-2b
      image_id: ami-022e8df2148a65830
      instance_type: t2.nano
  Idem_AWS_EC2_INSTANCE_2:
    type: Idem.AWS.EC2.INSTANCE
    properties:
      name: ${resource.Allocations_CustomNaming_1.selectedNames[1]}
      region: us-west-2
      account: aws
      availability_zone: us-west-2b
      image_id: ami-022e8df2148a65830
      instance_type: t2.nano

Provisionar um cluster de recursos com um modelo genérico

O modelo a seguir mostra como você pode usar um modelo genérico para provisionar um cluster de instâncias do AWS EC2. Nesse exemplo, você deve consultar o nome do modelo, my-custom-template.

formatVersion: 1
inputs: {}
resources:
  Allocations_CustomNaming_1:
    type: Allocations.CustomNaming
    properties:
      resourceType: Generic
      templateName: my-custom-template
      numberOfNamesToGenerate: 2
  Idem_AWS_EC2_INSTANCE_2:
    type: Idem.AWS.EC2.INSTANCE
    allocatePerInstance: true
    properties:
      name: ${resource.Allocations_CustomNaming_1.selectedNames[count.index]}
      region: us-west-2
      account: aws
      availability_zone: us-west-2b
      image_id: ami-022e8df2148a65830
      instance_type: t2.nano
      count: 2