Als Cloud-Administrator können Sie das Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung verwenden, um benutzerdefinierte Namen für Ihre Ressourcen in Automation Assembler zu generieren. Sie können das Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung mit allen Ressourcentypen verwenden.

Nachdem Sie benutzerdefinierte Benennungsvorlagen in Automation Assembler definiert haben, können Sie das Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung verwenden, um auf die benutzerdefinierten Benennungsvorlagen in der Design-Arbeitsfläche zu verweisen. Weitere Informationen finden Sie unter Benutzerdefinierte Benennung bereitgestellter Ressourcen in Automation Assembler.

Die folgenden Anwendungsfälle veranschaulichen, wie Sie das Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung mit dem Ressourcentyp Generisch und dem Ressourcentyp Maschine verwenden. Der Ressourcentyp Generisch deckt alle möglichen Ressourcen ab und ist ausschließlich mit dem Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung verknüpft.

Hinweis:

Wenn Sie eine benutzerdefinierte Benennungsvorlage mit dem Ressourcentyp Generisch erstellen, müssen Sie das Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung verwenden, um einen benutzerdefinierten Namen für Ihre Ressource zu generieren. Falls Sie das Hilfsprogramm für die Zuteilung nicht hinzufügen, wird kein Name für die Ressource generiert.

Weitere Informationen zur Zuteilung und zu Hilfsprogrammen für die Zuteilung finden Sie in Plug-In-basierte Designs und Bereitstellungen in Automation Assembler.

Bevor Sie beginnen

Sie müssen ein Cloud-Konto einrichten und Ihre Ressourceninfrastruktur erstellen, bevor Sie Hilfsprogramme für die Zuteilung verwenden können. Weitere Informationen finden Sie unter Hinzufügen von Cloud-Konten und Erstellen der Ressourceninfrastruktur.

Erstellen einer generischen Benennungsvorlage

Sie müssen eine benutzerdefinierte Benennungsvorlage erstellen, damit Sie das Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung verwenden können. In diesem Beispiel erstellen Sie für Ihre Bereitstellungen eine Benennungsvorlage Generisch auf Organisationsebene. Benennungsvorlagen auf Organisationsebene werden standardmäßig auf alle Bereitstellungen angewendet.

Sie können auch Benennungsvorlagen auf Projektebene erstellen. Weitere Informationen finden Sie unter Benutzerdefinierte Benennung bereitgestellter Ressourcen in Automation Assembler.

So erstellen Sie eine Benennungsvorlage auf Organisationsebene:

  1. Wählen Sie Infrastruktur > Verwaltung > Benutzerdefinierte Namen aus und klicken Sie auf Neuer benutzerdefinierter Name.
  2. Geben Sie einen Namen und eine Beschreibung für die benutzerdefinierte Benennungsvorlage ein.
  3. Wählen Sie Organisation als Geltungsbereich aus.
  4. Klicken Sie auf Neue Benennungsvorlage und konfigurieren Sie die folgenden Optionen.
    Option Wert
    Ressourcentyp Generisch
    Vorlagenname my-custom template

    Der Vorlagenname ist eine benutzerdefinierte Zeichenfolge und dient als Bezeichner für die angegebene Vorlage.

    Beim Ressourcentyp Generisch muss der Vorlagenname angegeben werden.

    Wenn Sie Maschine als Ressourcentyp auswählen, müssen Sie nicht auf den Vorlagennamen verweisen, da Sie pro Projekt nur eine Vorlage des Typs „Maschine“ erstellen können.
    Vorlagenformat resource-${#####}
    Startwert des Indikators 1
    Inkrement 1

    Mit dieser Konfiguration werden die Bereitstellungen in den zugewiesenen Projekten von diesem Startpunkt aus inkrementiert.

    In diesem Beispiel, in dem der Startindikator 1 und der Inkrementwert 1 ist, wird die erste Bereitstellung mit 2 nummeriert. Wenn Sie die Bereitstellung bei 1 starten möchten, dann legen Sie den Startindikator auf Null und den Inkrementschritt auf 1 fest.
  5. Klicken Sie auf Hinzufügen.
  6. Fügen Sie bei Bedarf zusätzliche benutzerdefinierte Benennungsvorlagen hinzu.
  7. Klicken Sie auf Erstellen.

Die folgenden Abschnitte enthalten einige Beispiele für Vorlagen, in denen das Hilfsprogramm für die Zuteilung zur benutzerdefinierten Benennung verwendet wird.

Bereitstellen einer Ressource mit einer generischen Vorlage

Die folgende Cloud-Vorlage zeigt, wie Sie eine Vorlage vom Typ Generisch verwenden, um einen Namen für eine Plug-In-basierte AWS EC2-Instanz zu generieren. In diesem Beispiel müssen Sie auf den Namen der Vorlage, my-custom-template verweisen.

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

Bereitstellen einer Ressource mit einer Maschinenvorlage

Die folgende Vorlage zeigt, wie Sie eine Vorlage vom Typ Maschine verwenden können, um eine benutzerdefinierte Benennung für eine AWS EC2-Instanz zu generieren. Sie müssen den Namen der Vorlage nicht angeben, da Sie pro Projekt nur eine Maschinenvorlage erstellen können.

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

Bereitstellen mehrerer Ressourcen mit einer Maschinenvorlage

Die folgende Vorlage zeigt, wie Sie eine Vorlage vom Typ Maschine verwenden können, um Namen für mehrere AWS EC2-Instanzen zu generieren. Sie müssen den Namen der Vorlage nicht angeben, da Sie pro Projekt nur eine Maschinenvorlage erstellen können.

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

Bereitstellen eines Ressourcenclusters mit einer generischen Vorlage

Die folgende Vorlage zeigt, wie Sie eine generische Vorlage verwenden können, um einen Cluster aus AWS EC2-Instanzen bereitzustellen. In diesem Beispiel müssen Sie auf den Namen der Vorlage, my-custom-template verweisen.

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