配置参考信息

从 Red Hat OpenShift Web 控制台创建实例

要使用 Red Hat OpenShift Web 控制台创建配置对象，请完成以下步骤:

1. 创建所需的配置文件类型; 例如， accounts.yaml， generic.zip或 odbc.ini。 有关受支持的配置类型以及如何创建所需配置文件的信息，请参阅 配置类型。
   提示: 如果要在将来更新配置，您可能会发现将此文件备份到首选位置很有用。 例如，如果需要更新 accounts.yaml 文件中存储的凭证，那么只需在运行 Base64 编码器之前覆盖该文件中过时的帐户详细信息，如 从 Red Hat OpenShift Web 控制台更新实例 和 从 Red Hat OpenShift CLI 或 Kubernetes CLI 更新实例中所述。
2. 对配置文件运行 Base64 编码器并保存生成的值。

   
   缺省情况下，在创建配置对象时，操作程序将自动生成用于存储此 Base64-encoded 值的私钥，但您也可以选择手动创建私钥以存储您在上一步中创建的配置文件的内容。 如果您希望创建自己的私钥，那么可以跳过此步骤。

   提示: 根据您的操作系统，可以使用命令 (例如 base64， echo或 certutil ) 对文件或字符串中的数据进行 Base64 编码。 例如，对于可以指定为 JSON 格式的字符串的配置类型 (例如 BarAuth 或 S3Credentials) ，您可以通过在 Linux 上运行命令来直接 Base64-encocde 命令行中的 JSON 内容，如下所示:

   echo -n 'JSONcontent' | base64

   示例：

   echo -n '{"authType":"BASIC_AUTH","credentials":{"username":"joebloggs@email.com","password":"myPassword"}}' | base64

3. 从浏览器窗口，登录到 Red Hat OpenShift Container Platform Web 控制台。 确保您处于 " 管理员 " 透视图 中。
4. 可选。 如果要创建的配置类型包含敏感数据 (私钥) ，请创建私钥以安全地存储 Base64-encoded 值。 此类配置类型的示例包括 Accounts， Agentx和 setdbparms.txt。 (有关哪些配置类型包含私钥的信息，请转至 了解有关配置类型的更多信息，单击配置类型的链接，然后检查 配置类型的密钥详细信息摘要 表中的 包含私钥 列。)
   注: 仅当您希望手动创建和管理自己的私钥时，才会执行此步骤。 如果跳过此步骤，那么缺省情况下会自动生成私钥以在保存配置时存储 Base64-encoded 值 (在 "表单" 视图的 数据 字段或 YAML 视图的 spec.data 中指定)。
   1. 在导航中，单击 工作负载 > 密钥。
   2. 如果需要，请选择安装了 IBM App Connect 操作程序的名称空间 (项目)。
   3. 单击 创建 > 密钥/值私钥 ，然后在 私钥名称 字段中指定私钥的名称。
   4. 在 键 字段中指定 configuration 。
   5. 要完成 值 字段，请浏览或使用拖放来选择配置文件，或者直接将配置文件的内容粘贴到该字段中。
   6. 单击创建。
   7. 记下私钥名称，以便您可以在创建配置对象时对其进行指定。
5. 在导航中，单击 操作程序 > 已安装的操作程序。
6. 如果需要，请选择安装了 IBM App Connect 操作程序的名称空间 (项目)。
7. 从 " 已安装的操作程序 " 页面，单击 IBM App Connect。
8. 从 App Connect 操作程序的 操作程序详细信息 页面中，单击 配置 选项卡。 任何先前创建的配置对象都将显示在表中。
9. 单击 创建配置。

   从 " 操作程序详细信息 " 页面上的 详细信息 选项卡中，您还可以找到 配置 磁贴，然后单击 创建实例 以指定配置对象的定制资源设置。

10. 要使用 "表单" 视图，请按如下所示填写字段:
    • 名称: 指定可用来标识配置对象的唯一短名称。
    • 类型: 从下拉列表中，选择要创建的配置类型。 有关有效值的信息，请参阅 定制资源值 表中的 spec.type 。
    • 数据: 指定先前生成的 Base64-encoded 值。 (保存时，将自动生成用于存储此值的私钥。)
      注: 如果您手动创建了用于存储配置文件内容的私钥，请将此字段留空，并改为在 私钥名称 字段中指定该私钥。
    • 描述: 指定配置对象的描述。
    • 私钥名称: 如果您手动创建私钥以存储配置文件的内容，请在此字段中指定私钥。
      注: 如果在 数据 字段中指定了 Base64-encoded 值，请将此字段留空。
11. 可选: 如果您希望使用 YAML 视图，请单击 YAML 视图 ，然后使用此配置对象所需的参数和值更新 YAML 编辑器的内容。

    
    要查看可用参数和值的完整集合，请参阅 定制资源值。 (本节还描述了在创建配置对象之后如何存储 spec.data 值。)

    以下 YAML 代码显示了如果您未手动创建用于存储配置文件内容的私钥，那么配置定制资源设置应该是什么样子的示例。 请注意， spec.data 参数的值必须是您在先前步骤中生成的 Base64-encoded 文件内容。 metadata.name， metadata.namespace， spec.description和 spec.type 值表示要创建的配置类型的首选值。

    apiVersion: appconnect.ibm.com/v1beta1
    kind: Configuration
    metadata:
      name: acct-googleanalytics
      namespace: mynamespace
    spec:
      data: ThisRepresentsAveryLongBase64encodedDummyVaLue=
      description: Stores account details for Google Analytics
      type: accounts

    以下 YAML 代码显示了当您手动创建私钥以存储配置文件 (包含私钥) 的内容时，配置定制资源设置的外观示例。 请注意， spec.secretName 参数的值必须是此私钥的名称。

    apiVersion: appconnect.ibm.com/v1beta1
    kind: Configuration
    metadata:
      name: acct-googleanalytics
      namespace: mynamespace
    spec:
      description: Stores account details for Google Analytics
      secretName: scrt-googleanalytics
      type: accounts

12. 单击创建。 配置对象的条目显示在 "配置" 表中而不显示状态，因为配置对象仅表示在集成服务器，集成运行时， App Connect 仪表板或 App Connect Designer中引用的文档。
13. 单击配置对象名称以查看有关其定义的信息。

    您可以使用面包屑跟踪来返回到 (先前) 操作程序详细信息 页面。

下一步操作

• 如果适用，您可以通过在集成服务器或集成运行时的 spec.configuration 设置中指定配置对象的 metadata.name 值，将此配置应用于同一名称空间中的集成服务器或集成运行时。 有关更多信息，请参阅 集成服务器参考: 从 Red Hat OpenShift Web 控制台创建实例 和 集成运行时参考: 从 Red Hat OpenShift Web 控制台创建实例。

  如果创建此配置以用于集成服务器或集成运行时，那么可以将此配置应用于部署在 App Connect 仪表板 实例 (位于同一名称空间中) 中的集成服务器或集成运行时，如 创建集成服务器以运行 BAR 文件资源中所述。 创建集成服务器以运行 IBM App Connect Enterprise Toolkit 集成和 创建集成运行时以运行 BAR 文件资源。

• 如果创建了类型为 S3Credentials 的配置对象以用于同一名称空间中的 App Connect 仪表板 实例，那么可以通过在仪表板的 spec.storage.s3Configuration 设置中指定配置对象的 metadata.name 值，将此配置应用于仪表板。 有关更多信息，请参阅 仪表板参考: 从 Red Hat OpenShift Web 控制台创建实例。
• 如果创建了类型为 S3Credentials 的配置对象以用于同一名称空间中的 App Connect Designer 实例，那么可以通过在 Designer 的 spec.designerMappingAssist.incrementalLearning.storage.s3Configuration 设置中指定配置对象的 metadata.name 值，将此配置应用于 Designer 实例。 有关更多信息，请参阅 Designer 参考: 从 Red Hat OpenShift Web 控制台创建实例。

从 Red Hat OpenShift CLI 或 Kubernetes CLI 创建实例

要从 Red Hat OpenShift CLI 创建配置对象，请完成以下步骤。

1. 创建所需的配置文件类型; 例如， accounts.yaml， generic.zip或 odbc.ini。 有关受支持的配置类型以及如何创建所需配置文件的信息，请参阅 配置类型。
   提示: 如果要在将来更新配置，您可能会发现将此文件备份到首选位置很有用。 例如，如果需要更新 accounts.yaml 文件中存储的凭证，那么只需在运行 Base64 编码器之前覆盖该文件中过时的帐户详细信息，如 从 Red Hat OpenShift Web 控制台更新实例 和 从 Red Hat OpenShift CLI 或 Kubernetes CLI 更新实例中所述。
2. 对配置文件运行 Base64 编码器并保存生成的值。

   
   缺省情况下，在创建配置对象时，操作程序将自动生成用于存储此 Base64-encoded 值的私钥，但您也可以选择手动创建私钥以存储您在上一步中创建的配置文件的内容。 如果您希望创建自己的私钥，那么可以跳过此步骤。

   提示: 根据您的操作系统，可以使用命令 (例如 base64， echo或 certutil ) 对文件或字符串中的数据进行 Base64 编码。 例如，对于可以指定为 JSON 格式的字符串的配置类型 (例如 BarAuth 或 S3Credentials) ，您可以通过在 Linux 上运行命令来直接 Base64-encocde 命令行中的 JSON 内容，如下所示:

   echo -n 'JSONcontent' | base64

   示例：

   echo -n '{"authType":"BASIC_AUTH","credentials":{"username":"joebloggs@email.com","password":"myPassword"}}' | base64

3. 可选。 如果要创建的配置类型包含敏感数据 (私钥) ，请创建私钥以安全地存储 Base64-encoded 值。 此类配置类型的示例包括 Accounts， Agentx和 setdbparms.txt。 (有关哪些配置类型包含私钥的信息，请转至 了解有关配置类型的更多信息，单击配置类型的链接，然后检查 配置类型的密钥详细信息摘要 表中的 包含私钥 列。)
   注: 仅当您希望手动创建和管理自己的私钥时，才会执行此步骤。 如果跳过此步骤，那么缺省情况下会自动生成私钥，以在保存配置时存储 Base64-encoded 值 (在 spec.data中指定)。
   1. 从命令行使用 oc login 命令登录到 Red Hat OpenShift 集群。
   2. 运行以下命令：

      oc create secret generic secretName --from-file=configuration=configurationFileName --namespace=namespaceName

      其中：

      • secretName 是用于存储配置文件内容的私钥的名称。
      • configurationFileName表示配置文件的文件路径和名称。
      • namespaceName 是将在其中创建配置对象的名称空间。 如果您已登录到此名称空间，那么可以省略 --namespace 标志。

      示例：

      oc create secret generic scrt-googleanalytics --from-file=configuration=/mytempdir/accounts.yaml --namespace=mynamespace

      oc create secret generic scrt-googleanalytics --from-file=configuration=C:\mytempdir\accounts.yaml --namespace=mynamespace

   3. 记下私钥名称，以便您可以在创建配置对象时对其进行指定。
   4. 使命令窗口保持打开状态。
4. 从本地计算机中，创建包含要创建的对象的配置的 YAML 文件。 包含 metadata.namespace 参数以标识要在其中创建配置的名称空间; 这应该是创建其他 App Connect 实例或资源的名称空间。

   
   要查看可用参数和值的完整集合，请参阅 定制资源值。 (本节还描述了在创建配置对象之后如何存储 spec.data 值。)

   以下 YAML 代码显示了如果您未手动创建用于存储配置文件内容的私钥，那么配置定制资源设置应该是什么样子的示例。 请注意， spec.data 参数的值必须是您在先前步骤中生成的 Base64-encoded 文件内容。 metadata.name， metadata.namespace， spec.description和 spec.type 值表示要创建的配置类型的首选值。

   apiVersion: appconnect.ibm.com/v1beta1
   kind: Configuration
   metadata:
     name: acct-googleanalytics
     namespace: mynamespace
   spec:
     data: ThisRepresentsAveryLongBase64encodedDummyVaLue=
     description: Stores account details for Google Analytics
     type: accounts

   以下 YAML 代码显示了当您手动创建私钥以存储配置文件 (包含私钥) 的内容时，配置定制资源设置的外观示例。 请注意， spec.secretName 参数的值必须是此私钥的名称。

   apiVersion: appconnect.ibm.com/v1beta1
   kind: Configuration
   metadata:
     name: acct-googleanalytics
     namespace: mynamespace
   spec:
     description: Stores account details for Google Analytics
     secretName: scrt-googleanalytics
     type: accounts

5. 使用 .yaml 扩展名保存此文件; 例如， myconfig_cr.yaml。
6. 从命令行运行以下命令以在 Red Hat OpenShift 集群中创建配置。 (使用您创建的 .yaml 文件的名称。)

   oc apply -f myconfig_cr.yaml

   未向此配置对象分配状态，因为该对象仅表示在集成服务器，集成运行时， App Connect 仪表板或 App Connect Designer中引用的文档。

7. 运行以下任一命令以查看名称空间中的配置对象:

   oc get configurations -n namespace

   oc get configurations.appconnect.ibm.com -n namespace

   对于配置对象以及为已部署的集成服务器，集成运行时， App Connect 仪表板或 App Connect Designer 实例自动生成或手动创建的任何其他对象，您应该会看到与此类似的输出。

   NAME                                        AGE
   acct-googleanalytics                        16h
   des-01-quickstart-ma-designer-acc           16h
   des-01-quickstart-ma-designer-is-adminssl   16h
   des-01-quickstart-ma-designer-ks            16h
   des-01-quickstart-ma-designer-pp            16h
   des-01-quickstart-ma-designer-sc            16h
   des-01-quickstart-ma-designer-sdbp          16h
   des-01-quickstart-ma-designer-ssl           16h
   is-01-quickstart-is-adminssl                16h

下一步操作

• 如果适用，您可以通过在集成服务器或集成运行时的 spec.configuration 设置中指定配置对象的 metadata.name 值，将此配置应用于同一名称空间中的集成服务器或集成运行时。 有关更多信息，请参阅 集成服务器参考: 从 Red Hat OpenShift Web 控制台创建实例 和 集成运行时参考: 从 Red Hat OpenShift Web 控制台创建实例。

  如果创建此配置以用于集成服务器或集成运行时，那么可以将此配置应用于部署在 App Connect 仪表板 实例 (位于同一名称空间中) 中的集成服务器或集成运行时，如 创建集成服务器以运行 BAR 文件资源中所述。 创建集成服务器以运行 IBM App Connect Enterprise Toolkit 集成和 创建集成运行时以运行 BAR 文件资源。

• 如果创建了类型为 S3Credentials 的配置对象以用于同一名称空间中的 App Connect 仪表板 实例，那么可以通过在仪表板的 spec.storage.s3Configuration 设置中指定配置对象的 metadata.name 值，将此配置应用于仪表板。 有关更多信息，请参阅 仪表板参考: 从 Red Hat OpenShift CLI 或 Kubernetes CLI 创建实例。
• 如果创建了类型为 S3Credentials 的配置对象以用于同一名称空间中的 App Connect Designer 实例，那么可以通过在 Designer 的 spec.designerMappingAssist.incrementalLearning.storage.s3Configuration 设置中指定配置对象的 metadata.name 值，将此配置应用于 Designer 实例。 有关更多信息，请参阅 Designer 参考: 从 Red Hat OpenShift CLI 或 Kubernetes CLI 创建实例。

从 Red Hat OpenShift Web 控制台更新实例

要使用 Red Hat OpenShift Web 控制台更新配置对象，请完成以下步骤:

1. 如果需要，请更新用于创建配置对象的配置文件 (例如， accounts.yaml， generic.zip或 odbc.ini) 的内容。 然后对该文件运行 Base64 编码器并保存生成的值。 (如果配置类型包含敏感数据，您可以 (如果首选) 手动创建私钥以存储配置文件内容，而不是使用自动生成的私钥。) 有关受支持的配置类型以及有关每个文件内容的详细信息，请参阅 配置类型。
2. 从浏览器窗口，登录到 Red Hat OpenShift Container Platform Web 控制台。 确保您处于 " 管理员 " 透视图 中。
3. 在导航中，单击 操作程序 > 已安装的操作程序。
4. 如果需要，请选择安装了 IBM App Connect 操作程序的名称空间 (项目)。
5. 从 " 已安装的操作程序 " 页面，单击 IBM App Connect。
6. 从 App Connect 操作程序的 操作程序详细信息 页面中，单击 配置 选项卡。
7. 找到并单击要更新的配置对象的名称。
8. 单击 YAML 选项卡。
9. 根据需要更新 YAML 编辑器的内容。
   如果要更新配置对象的内容，请完成以下任一步骤:

   • 添加设置为更新后的 Base64-encoded 值的 spec.data 条目，然后除去 spec.secretName 条目。
   • 使用您手动创建的新私钥的名称覆盖 spec.secretName 值。

   有关可用参数及其值的更多信息，请参阅 定制资源值。

10. 单击保存以保存更改。

从 Red Hat OpenShift CLI 或 Kubernetes CLI 更新实例

要从 Red Hat OpenShift CLI 更新配置对象，请完成以下步骤。

1. 如果需要，请更新用于创建配置对象的配置文件 (例如， accounts.yaml， generic.zip或 odbc.ini) 的内容。 然后对该文件运行 Base64 编码器并保存生成的值。 (如果配置类型包含敏感数据，您可以 (如果首选) 手动创建私钥以存储配置文件内容，而不是使用自动生成的私钥。) 有关受支持的配置类型以及有关每个文件内容的详细信息，请参阅 配置类型。
2. 从命令行使用 oc login 命令登录到 Red Hat OpenShift 集群。
3. 从部署了配置对象的名称空间中，运行 oc edit 命令以部分更新该对象，其中 instanceName 是配置对象的名称 (metadata.name 值)。

   oc edit configuration instanceName

   配置 CR 将自动在操作系统的缺省文本编辑器中打开。

4. 根据需要更新文件内容。
   如果要更新配置对象的内容，请完成以下任一步骤:

   • 添加设置为更新后的 Base64-encoded 值的 spec.data 条目，然后除去 spec.secretName 条目。
   • 使用您手动创建的新私钥的名称覆盖 spec.secretName 值。

   有关可用参数及其值的更多信息，请参阅 定制资源值。

5. 保存 YAML 定义并关闭文本编辑器以应用更改。

从 Red Hat OpenShift Web 控制台中删除实例

要使用 Red Hat OpenShift Web 控制台删除配置对象，请完成以下步骤:

1. 从浏览器窗口，登录到 Red Hat OpenShift Container Platform Web 控制台。 确保您处于 " 管理员 " 透视图 中。
2. 在导航中，单击 操作程序 > 已安装的操作程序。
3. 如果需要，请选择安装了 IBM App Connect 操作程序的名称空间 (项目)。
4. 从 " 已安装的操作程序 " 页面，单击 IBM App Connect。
5. 从 App Connect 操作程序的 操作程序详细信息 页面中，单击 配置 选项卡。
6. 找到要删除的配置对象。
7. 单击选项图标 () 以打开选项菜单，然后单击 删除 选项。
8. 确认删除操作。

从 Red Hat OpenShift CLI 或 Kubernetes CLI 删除实例

要从 Red Hat OpenShift CLI 中删除配置对象，请完成以下步骤。

1. 从命令行使用 oc login 命令登录到 Red Hat OpenShift 集群。
2. 从部署了配置对象的名称空间中，运行以下命令以删除此对象，其中 configurationName 是 metadata.name 参数的值。

   oc delete configuration configurationName