Weiterreichen von Eigenschaften von Blueprints an die Ressourcenverzeichnisstruktur

Über den Blueprint Designer können Sie Eigenschaften der Komponentenumgebung und der Komponentenressource im Blueprint-Quellcode festlegen.

Vorbereitende Schritte

Verbinden des Blueprint Designers mit dem Server. Siehe Verbinden des Blueprint-Design-Servers mit dem Server.

Informationen zu diesem Vorgang

Sie können die folgenden Eigenschaften aus einem Blueprint an eine Ressourcenverzeichnisstruktur weiterreichen:

Komponentenressourceneigenschaften
Komponentenumgebungseigenschaften
Sichere Komponentenressourceneigenschaften
Sichere Umgebungsressourceneigenschaften
Umgebungseigenschaften

Blueprints können Umgebungseigenschaften erstellen, allerdings müssen Komponentenressourceneigenschaften und Komponentenumgebungseigenschaften für eine Komponente vorhanden sein, bevor Sie Werte an sie weiterreichen können. Wenn Sie keine Werte für diese Eigenschaften aus dem Blueprint Designer angeben, werden für die Eigenschaften die Standardwerte verwendet, die in IBM® UrbanCode Deploy festgelegt wurden.

Vorgehensweise

Öffnen Sie im Blueprint Designer einen Blueprint.
Fügen Sie dem Blueprint ein oder mehrere Bilder hinzu.
Führen Sie die folgende Schritte aus, um Komponentenumgebungseigenschaften weiterzureichen:
1. Erstellen Sie auf der Registerkarte Konfiguration einer Komponente eines Servers eine oder mehrere Komponentenumgebungseigenschaften. Die folgende Abbildung zeigt beispielsweise eine Komponente mit zwei Komponentenumgebungseigenschaften an:
2. Fügen Sie die Komponente im Blueprint Designer über die Kategorie Komponenten einem virtuellen Image hinzu. In der Ressource IBM::UrbanCode::SoftwareConfig::UCD werden die Komponentenumgebungseigenschaften im Abschnitt inputs als Name/Wert-Paare angezeigt. Die Eigenschaften werden auch auf der Registerkarte Eigenschaften des Editors angezeigt. Der folgende Beispielcode zeigt zwei Komponentenumgebungseigenschaften:
```
component1_sw_config:
  type: IBM::UrbanCode::SoftwareConfig::UCD
  properties:
    name: "component1"
    component_process: "Deploy component1"
    component_process_timeout: "300"
    ucd_server_url: { get_param: ucd_server_url }
    ucd_username: { get_param: ucd_user }
    ucd_password: { get_param: ucd_password }
    application: { get_attr: [resource_tree, application_name] }
    environment_name: { get_attr: [resource_tree, environment_name] }
    inputs:
      CompEnvProp1 : "Default value for CompEnvProp1"
      CompEnvProp2 : "Default value for CompEnvProp2"
```
3. Werte für die Komponentenumgebungseigenschaften im Blueprint angeben. Sie können Literalwerte angeben, oder Sie können die Funktionen get_attr und get_param angeben, um Attribut- und Parameterwerte abzurufen.
Führen Sie die folgenden Schritte aus, um Komponentenressourceneigenschaften weiterzureichen:
1. Erstellen Sie auf der Registerkarte Konfiguration einer Komponente auf dem Server eine oder mehrere Komponentenressourceneigenschaften.
2. Fügen Sie die Komponente im Blueprint-Editor über den Einschub Komponenten einem virtuellen Image hinzu. In der Ressource IBM::UrbanCode::SoftwareDeploy::UCD werden die Komponentenressourceneigenschaften im Abschnitt inputs als Name/Wert-Paare angezeigt. Die Eigenschaften werden auch auf der Registerkarte Eigenschaften des Editors angezeigt. Der folgende Beispielcode zeigt eine Komponentenressourceneigenschaft an:
```
component1:
  type: IBM::UrbanCode::SoftwareDeploy::UCD
  properties:
    apply_config: { get_resource: component1_sw_config }
    server: my_server
    version: LATEST
    agent_timeout: "360"
    inputs:
      CompResourceProp1 : "Default value for CompResourceProp1"
```
3. Werte für die Komponentenressourceneigenschaften im Blueprint angeben. Sie können Literalwerte angeben, oder Sie können die Funktionen get_attr und get_param angeben, um Attribut- und Parameterwerte abzurufen.
Führen Sie die folgenden Schritte aus, um Umgebungseigenschaften weiterzureichen:
1. Fügen Sie im Blueprint-Editor über den Einschub Komponenten einem virtuellen Image mindestens eine Komponente hinzu. Dieser Schritt ist erforderlich, um die Ressource resource_tree im Blueprint-Code zu erstellen und aufzufüllen.
2. Fügen Sie in der Ressource resource_tree im Abschnitt properties Umgebungseigenschaften hinzu und geben Sie Werte für sie an. Der folgende Code zeigt beispielsweise eine Umgebungseigenschaft mit dem Namen tomcat_port an:
```
resource_tree:
 properties:
  inputs:
   tomcat_port : "8443"
```
Führen Sie die folgende Schritte aus, um den Wert einer sicheren Komponentenressource oder von Komponentenumgebungseigenschaften zu ändern:
Einschränkung: Sie können den Wert dieser sicheren Eigenschaften nicht im Blueprint-Quellcode ändern.
1. Erstellen Sie auf der Registerkarte Konfiguration einer Komponente auf dem Server eine oder mehrere Komponentenressourceneigenschaften.
2. Fügen Sie die Komponente im Blueprint-Editor über den Einschub Komponenten einem virtuellen Image hinzu. In der Ressource IBM::UrbanCode::SoftwareDeploy::UCD werden die sicheren Eigenschaften im Abschnitt inputs als Paare aus einem Namen und der Funktion get_param angezeigt. Da der Wert der Eigenschaft sicher ist, wird er nicht im Blueprint angezeigt. Die Eigenschaften werden auch auf der Registerkarte Eigenschaften des Editors angezeigt. An die Namen der sicheren Eigenschaften wird -SECURE-PROPERTY angehängt, wie im folgenden Beispiel gezeigt:
```
component1:
  type: IBM::UrbanCode::SoftwareDeploy::UCD
  properties:
    apply_config: { get_resource: component1_sw_config }
    server: my_server
    version: LATEST
    agent_timeout: "360"
    inputs:
      Name_der_sicheren_Eigenschaft-SECURE-PROPERTY : {get_param: Name_der_sicheren_Eigenschaft_secure_property}
```
  Im Abschnitt Parameter des Blueprint wird die Definition jeder sicheren Eigenschaft angezeigt. An die Namen der sicheren Eigenschaften wird _secure_property angehängt und die Beschreibung jeder sicheren Eigenschaft sowie eine Platzhalterzeichenfolge für das Kennwort werden angezeigt, wie im folgenden Beispiel gezeigt:
```
Name_der_sicheren_Eigenschaft_secure_property
  type: string
  description: 'Secure property definition'
  default: 'DefaultComponentPasswordValue'
  hidden: true
```
3. Wenn Sie den Blueprint bereitstellen, geben Sie Werte für die sicheren Eigenschaften an. Siehe Provisioning environments from the blueprint designer (through OpenStack Heat).
Speichern Sie den Blueprint.

Nächste Schritte

Nach Bereitstellen der Umgebung reicht der Blueprint Designer die Eigenschaftswerte im Blueprint-Quellcode an die Eigenschaften auf dem Server weiter. In Prozessen können Sie im selben Format auf die Eigenschaften verweisen wie bei jeder anderen Eigenschaft. Sie können zum Beispiel im folgenden Format auf Umgebungseigenschaften verweisen: ${p:environment/property_name}.

Feedback