身為雲端管理員，您可以在 Automation Assembler 中使用自訂命名配置協助程式為資源產生自訂名稱。您可以對任何資源類型使用自訂命名配置協助程式。

在 Automation Assembler 中定義自訂命名範本後，可以使用自訂命名配置協助程式在設計畫布中參照自訂命名範本。如需詳細資訊，請參閱〈自訂資源命名〉。

以下使用案例示範了如何對一般資源類型和機器資源類型使用自訂命名配置協助程式。一般資源類型涵蓋所有可能的資源，並專門連結到自訂命名配置協助程式。

備註：

建立具有一般資源類型的自訂命名範本時，必須使用自訂命名配置協助程式為資源產生自訂名稱。如果不新增配置協助程式，將不會為資源產生名稱。

如需有關配置和配置協助程式的詳細資訊，請參閱〈Automation Assembler 中以外掛程式為基礎的設計和部署〉。

開始之前

必須先設定雲端帳戶並建置資源基礎結構，然後才能使用配置協助程式。如需詳細資訊，請參閱〈新增雲端帳戶〉和〈建置資源基礎結構〉。

建立一般命名範本

您必須建立自訂命名範本才能使用自訂命名配置協助程式。在此範例中，將為部署建立一般、組織層級命名範本。依預設，組織層級的命名範本將套用至所有部署。

您也可以建立專案層級命名範本。如需詳細資訊，請參閱〈自訂資源命名〉。

建立組織層級命名範本：

  1. 選取基礎結構 > 管理 > 自訂名稱，然後按一下新增自訂名稱。
  2. 輸入自訂命名範本的名稱和說明。
  3. 選取組織作為範圍。
  4. 按一下新增命名範本並設定以下選項。
    選項 值
    資源類型 一般
    範本名稱 my-custom template

    範本名稱是使用者定義的字串，用作指定範本的識別碼。

    如果資源類型為一般，則必須指定範本名稱。

    如果選擇機器作為資源類型，則無需參照範本名稱，因為每個專案只能建立一個機器類型的範本。
    範本格式 resource-${#####}
    起始計數器值 1
    增量步長 1

    透過此組態，已指派專案中的部署將從此起點遞增。

    在此範例中，起始計數器為 1，增量為 1，第一個部署編號為 2。如果部署需要從 1 開始，則將起始計數器設定為零，並將增量步長設定為 1。
  5. 按一下新增。
  6. 如有需要，請新增其他自訂命名範本。
  7. 按一下建立。

以下區段包含一些使用自訂命名配置協助程式的範本範例。

使用一般範本布建資源

以下雲端範本顯示了如何使用一般類型的範本為以外掛程式為基礎的 AWS EC2 執行個體產生名稱。在此範例中，必須參照範本的名稱 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

使用機器範本布建資源

以下範本顯示了如何使用機器類型的範本為 AWS EC2 執行個體產生自訂命名。您無需指定範本的名稱，因為每個專案只能建立一個機器範本。

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

使用機器範本佈建多個資源

以下範本顯示了如何使用機器類型的範本為多個 AWS EC2 執行個體產生名稱。您無需指定範本的名稱，因為每個專案只能建立一個機器範本。

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

使用一般範本布建資源叢集

以下範本顯示了如何使用一般範本佈建 AWS EC2 執行個體叢集。在此範例中，必須參照範本的名稱 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