Als cloudbeheerder kunt u de toewijzingshelper voor aangepaste naamgeving gebruiken om aangepaste namen te genereren voor uw resources in Automation Assembler. U kunt de toewijzingshelper voor aangepaste naamgeving met elk resourcetype gebruiken.

Nadat u sjablonen voor aangepaste naamgeving in Automation Assembler heeft gedefinieerd, kunt u de toewijzingshelper voor aangepaste naamgeving gebruiken om te verwijzen naar de sjablonen voor aangepaste naamgeving in het Ontwerpcanvas. Zie Aangepaste naamgeving van resources voor meer informatie.

Deze gebruiksscenario's demonstreren hoe u de toewijzingshelper voor aangepaste naamgeving kunt gebruiken met het resourcetype Algemeen en het resourcetype Machine. Het resourcetype Algemeen is van toepassing voor alle mogelijke resources en is uitsluitend gekoppeld aan de toewijzingshelper voor aangepaste naamgeving.

Opmerking:

Wanneer u een sjabloon voor aangepaste naamgeving maakt met het resourcetype Algemeen, moet u de toewijzingshelper voor aangepaste naamgeving gebruiken om een aangepaste naam voor uw resource te genereren. Als u de toewijzingshelper niet toevoegt, wordt er geen naam voor de resource gegenereerd.

Zie Ontwerpen en implementaties op basis van de plug-in in Automation Assembler voor meer informatie over toewijzing en toewijzingshelpers.

Voordat u begint

U moet een cloudaccount instellen en uw resource-infrastructuur bouwen voordat u toewijzingshelpers kunt gebruiken. Zie Cloudaccounts toevoegen en Uw resource-infrastructuur bouwen voor meer informatie.

Een sjabloon voor algemene naamgeving maken

U moet een sjabloon voor aangepaste naamgeving maken om de toewijzingshelper voor aangepaste naamgeving te gebruiken. In dit voorbeeld maakt u een naamgevingssjabloon op het organisatieniveau Algemeen voor uw implementaties. Naamgevingssjablonen op organisatieniveau worden standaard toegepast op alle implementaties.

U kunt ook naamgevingssjablonen op projectniveau maken. Zie Aangepaste naamgeving van resources voor meer informatie.

Een naamgevingssjabloon op organisatieniveau maken:

  1. Selecteer Infrastructuur > Beheer > Aangepaste namen en klik op Nieuwe aangepaste naam.
  2. Voer een naam en beschrijving in voor de sjabloon voor aangepaste naamgeving.
  3. Selecteer Organisatie als bereik.
  4. Klik op Nieuwe naamgevingssjabloon en configureer de volgende opties.
    Optie Waarde
    Resourcetype Algemeen
    Naam van sjabloon my-custom template

    De sjabloonnaam is een door de gebruiker gedefinieerde tekenreeks en fungeert als id voor de opgegeven sjabloon.

    De sjabloonnaam moet worden opgegeven als het resourcetype Algemeen is.

    Als u Machine als resourcetype kiest, hoeft u niet te verwijzen naar de sjabloonnaam omdat u slechts één sjabloon van het type Machine per project kunt maken.
    Sjabloonindeling resource-${#####}
    Beginwaarde voor teller 1
    Stap van toename 1

    Met deze configuratie worden alle implementaties in de toegewezen projecten vanaf dit beginpunt verhoogd.

    In dit voorbeeld, waarbij de teller 1 en de toename 1 is, krijgt de eerste implementatie het nummer 2. Als u wilt dat de implementatie begint bij 1, stelt u vervolgens de teller in op nul en de stap van de toename op 1.
  5. Klik op Toevoegen.
  6. Voeg indien nodig extra sjablonen voor aangepaste naamgeving toe.
  7. Klik op Maken.

De volgende secties bevatten enkele voorbeelden van sjablonen die de toewijzingshelper voor aangepaste naamgeving gebruiken.

Een resource inrichten met een algemene sjabloon

In de volgende cloudsjabloon ziet u hoe u een sjabloon van het type Algemeen gebruikt om een naam te genereren voor een AWS EC2-instantie op basis van de plug-in. In dit voorbeeld moet u verwijzen naar de naam van de sjabloon, 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

Een resource inrichten met een machinesjabloon

In de volgende sjabloon ziet u hoe u een sjabloon van het type Machine kunt gebruiken om een aangepaste naamgeving te genereren voor een AWS EC2-instantie. U hoeft de naam van de sjabloon niet op te geven, omdat u slechts één machinesjabloon per project kunt maken.

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

Meerdere resources inrichten met een machinesjabloon

In de volgende sjabloon ziet u hoe u een sjabloon van het type Machine kunt gebruiken om namen te genereren voor meerdere AWS-EC2-instanties. U hoeft de naam van de sjabloon niet op te geven, omdat u slechts één machinesjabloon per project kunt maken.

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

Een cluster van resources inrichten met een algemene sjabloon

In de volgende sjabloon ziet u hoe u een algemene sjabloon kunt gebruiken om een cluster van AWS-EC2-instanties in te richten. In dit voorbeeld moet u verwijzen naar de naam van de sjabloon, 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