将 IBM 软件安装到 IBM Cloud Private

您可以将其他 IBM 软件安装到 IBM® Cloud Private 以扩展 IBM Cloud Private 平台的功能或者添加到 IBM Cloud Private Catalog。

提供两个选项以将 IBM 软件安装到 IBM Cloud Private：

将 IBM 软件添加到 IBM Cloud Private Catalog：您可以使用 CLI 以手动安装 IBM 软件，然后将 Helm Chart 装入到 IBM Cloud Private Catalog。
将 IBM 软件安装到 IBM Cloud Private 平台：您可以使用 IBM Cloud Private 安装程序以立即在计算机上安装和激活 IBM 软件。

您可以通过 IBM Cloud Private 捆绑软件、IBM Cloud Paks 和 IBM Certified Containers 获取可与 IBM Cloud Private 集成的 IBM 软件。每个 IBM Cloud Private 捆绑软件和 IBM Cloud Pak 包含从 IBM Passport Advantage 下载的不同的授权软件。因为添加新的附加组件，Passport Advantage 上提供的附加组件列表频繁更改。有关更多信息，请参阅 IBM Cloud Private 捆绑软件、识别 IBM Cloud Paks 和识别 IBM Certified Containers。

所需用户类型或访问级别：集群管理员或团队管理员

将 IBM 软件添加到 IBM Cloud Private Catalog

对于可与 IBM® Cloud Private 集成的其他产品，必须手动安装 Helm Chart。

在装入 Chart 之前，请先满足以下先决条件：

安装 IBM Cloud Private。请参阅安装 IBM Cloud Private Cloud Native、Enterprise 和 Community 版本。
安装 IBM Cloud Private CLI 并登录集群。请参阅安装 IBM Cloud Private CLI。
配置从计算机到 Docker 专用映像注册表主机的认证，然后登录专用注册表。请参阅配置 Docker CLI 的认证。
如果您不是 root 用户，请确保您的帐户属于 docker 组。请参阅 Docker 文档中的 Post-installation steps for Linux® 。
请确保计算机和集群之间的网络连接稳定。

要安装 IBM 软件并将 Helm Chart 装入到 Catalog：

从 IBM Passport Advantage® 下载压缩文件。
确保有足够的磁盘空间可将压缩文件中的映像装入计算机。
1. 通过运行下列命令，检查 Docker 磁盘使用率：
```
docker system df
```
  要获取更多命令选项，请参阅 Docker 文档中的 docker system df 。
2. 如果需要更多磁盘空间，请执行以下操作之一：
  - 移除旧的 Docker 映像。
  - 增加 Docker 守护程序使用的存储量。要增大 Docker 守护程序使用的存储量，请查看 dockerd Docker 文档中的 dm.basesize 条目。
从 IBM Cloud Private CLI 登录集群，然后登录 Docker 专用映像注册表。
```
cloudctl login -a https://<Cluster Master Host>:<Cluster Master API Port> --skip-ssl-validation
docker login <cluster_CA_domain>:8500
```
其中，<Cluster Master Host>:<Cluster Master API Port> 在主端点中定义。cluster_CA_domain 是认证中心 (CA) 域。如果未指定 CA 域，那么缺省值为 mycluster.icp。请参阅为 IBM Cloud Private 服务指定您自己的认证中心 (CA)。
从 Passport Advantage 安装文件：
- 对于 Linux 或 Windows，运行以下命令：
```
cloudctl catalog load-archive --archive <compressed_file_name> --registry mycluster.icp:8500/namespace
```
  compressed_file_name 是从 Passport Advantage 下载的文件名称，--registry 是将 Docker 映像推送至其中的注册表，namespace 是托管 Docker 映像的 Docker 名称空间。
- 对于 macOS，运行以下命令：
```
cloudctl catalog load-archive --archive <compressed_file_name> --username user --password pass --registry mycluster.icp:8500/namespace
```
注：--registry 参数不是必需的。如果未指定 --registry 参数，那么映像将上载至与缺省集群 CA 域和当前目标名称空间关联的注册表。
查看 IBM Cloud Private Catalog中的 Chart：

从 IBM Cloud Private management console 中，单击目录。新的 Helm Chart 将装入Catalog中，然后您可以将其安装到集群。

注：只能使用Catalog装入 Helm Chart。不能使用 Helm CLI 装入 Chart。

将 IBM 软件安装到 IBM Cloud Private 平台

您可以使用 IBM Cloud Private 安装程序以立即在计算机上安装和激活 IBM 软件。

开始之前，必须已安装版本为 3.2.0 或更高版本的 IBM Cloud Private 或 IBM Cloud Private-CE。

要将 IBM 软件安装到 IBM Cloud Private：

从 IBM Passport Advantage® 下载压缩文件。
可选：准备归档依赖关系 yaml 资源文件。
可选：在 cluster 目录中创建名为 resources 的目录，并将 yaml 资源文件放置其下。
```
 mkdir -p cluster/resources
 mv your-resource.yaml cluster/resources/
```
通过运行以下命令，在 cluster 目录中创建名为 addon 的目录：
```
 mkdir -p cluster/addon
```
将归档软件包移至刚刚创建的目录。例如：
```
 mv software-version.tgz cluster/addon/
```
通过添加以下内容，更新 cluster/config.yaml 文件。例如：
```
 archive_addons:
   software_name:
     namespace: default
     repo: local-charts
     path: addon/software-version.tgz

     charts:
       - name: software
         values:
           service:
           name: software-service
```
以下列表描述示例中的内容：
- namespace：想要上载 IBM Passport Advantage 映像并安装 IBM Passport Advantage Chart 的名称空间。
- repo：想要上载 IBM Passport Advantage Chart 的 Helm 存储库。这可以是 local-charts 或 mgmt-charts。
- path：相对于 cluster 目录的 IBM Passport Advantage 软件包路径。
- charts：想要安装的 Chart 的列表。如果未列出 Chart，那么不会安装任何 Chart。
- charts[].name：随 IBM Cloud Private 安装一起安装的 Passport Advantage Chart。
- charts[].values：IBM Passport Advantage Chart 的定制值。
运行 IBM Cloud Private 安装命令。安装程序将指定的 Chart 和映像上载到 Helm 存储库和注册表。