最佳实践: 设置安装变量

准备工作

在创建脚本之前，请考虑您是否需要支持:

跨集群的可重复部署

在此场景中，您可以复用同一脚本来提高整个环境中部署的一致性。

同一集群上的多个部署

在此场景中，您可以创建多个脚本以简化管理每个实例的过程。 请明确命名每个脚本，以确保在运行安装命令之前运行正确的脚本。

创建环境变量文件

1. 将以下示例复制到本地文件系统上的文本编辑器:

   #===============================================================================
   # Cloud Pak for Data installation variables
   #===============================================================================
   
   # ------------------------------------------------------------------------------
   # Cluster variables
   # ------------------------------------------------------------------------------
   
   export OCP_URL=<enter your Red Hat OpenShift Container Platform URL>
   
   
   # ------------------------------------------------------------------------------
   # Project variables
   # ------------------------------------------------------------------------------
   
   export PROJECT_CPFS_OPS=ibm-common-services        
   export PROJECT_CPD_OPS=<enter your Cloud Pak for Data operator installation project>
   export PROJECT_CATSRC=openshift-marketplace
   export PROJECT_CPD_INSTANCE=<enter your Cloud Pak for Data installation project>
   # export PROJECT_TETHERED=<enter the tethered project>
   
   
   # ------------------------------------------------------------------------------
   # Operator installation variables
   # ------------------------------------------------------------------------------
   
   export APPROVAL_TYPE=Automatic
   
   
   # ------------------------------------------------------------------------------
   # Licenses variables
   # ------------------------------------------------------------------------------
   
   export LICENSE_CPD=<enter the license you purchased>
   
   # ------------------------------------------------------------------------------
   # IBM Entitled Registry variables
   # ------------------------------------------------------------------------------
   
   export IBM_ENTITLEMENT_KEY=<enter your IBM entitlement API key>
   export IBM_ENTITLEMENT_USER=cp
   export IBM_ENTITLEMENT_SERVER=cp.icr.io
   
   
   # ------------------------------------------------------------------------------
   # CASE package management variables
   # ------------------------------------------------------------------------------
   
   export OFFLINEDIR_CPD=<enter an existing directory>
   export OFFLINEDIR_CPFS=<enter an existing directory>
   export PATH_CASE_REPO=https://github.com/IBM/cloud-pak/raw/master/repo/case
   export USE_SKOPEO=true
   
   
   # ------------------------------------------------------------------------------
   # Private container registry variables
   # ------------------------------------------------------------------------------
   # Set the following variables if you mirror images to a private container registry.
   #
   # To export these variables, you must uncomment each command in this section.
   
   # export PRIVATE_REGISTRY_LOCATION=<enter the location of your private container registry>
   # export PRIVATE_REGISTRY_PUSH_USER=<enter the username of a user that can push to the registry>
   # export PRIVATE_REGISTRY_PUSH_PASSWORD=<enter the password of the user that can push to the registry>
   # export PRIVATE_REGISTRY_PULL_USER=<enter the username of a user that can pull from the registry>
   # export PRIVATE_REGISTRY_PULL_PASSWORD=<enter the password of the user that can pull from the registry>
   
   
   # ------------------------------------------------------------------------------
   # Intermediary container registry variables
   # ------------------------------------------------------------------------------
   # Set the following variables if you use an intermediary container registry to
   # mirror images to your private container registry.
   #
   # To export these variables, you must uncomment each command in this section.
   
   # export INTERMEDIARY_REGISTRY_HOST=localhost
   # export INTERMEDIARY_REGISTRY_PORT=<enter the port to use on the localhost>
   # INTERMEDIARY_REGISTRY_LOCATION="${INTERMEDIARY_REGISTRY_HOST}:${INTERMEDIARY_REGISTRY_PORT}"
   # export INTERMEDIARY_REGISTRY_LOCATION
   # export INTERMEDIARY_REGISTRY_USER=<enter the username to authenticate to the registry>
   # export INTERMEDIARY_REGISTRY_PASSWORD=<enter the password for the user>

2. 针对您的环境更新脚本中的每个部分。 请参阅以下各节，以了解脚本的每个部分中的变量和有效值:
   • 聚类变量
   • 项目变量
   • 操作程序安装变量
   • IBM 授权注册表变量
   • CASE 包管理变量
   • 专用容器注册表变量
   • 中间容器注册表变量
3. 将文件另存为 shell 脚本。 例如，将文件另存为 cpd_vars.sh。
4. 请确认该脚本不包含任何错误。 例如，如果您将脚本命名为 cpd_vars.sh，请运行:

   bash ./cpd_vars.sh

5. 如果您将密码存储在文件中，请阻止其他人读取该文件。 例如，如果您将脚本命名为 cpd_vars.sh，请运行:

   chmod 700 cpd_vars.sh

对环境变量进行寻源

在运行安装和升级命令之前，将该脚本的副本保存到工作站并从 bash 提示符运行该脚本。 该脚本将环境变量导出到命令行会话。

1. 切换至您保存脚本的目录。
2. 对环境变量进行源。 例如，如果您将脚本命名为 cpd_vars.sh，请运行:

   source ./cpd_vars.sh

聚类变量

脚本的 集群变量 部分中的变量指定有关 Red Hat® OpenShift® Container Platform 集群的信息。

项目变量

脚本的 项目变量 部分中的变量指定由 Cloud Pak for Data 组成的组件安装到的位置。

操作程序安装变量

该脚本的 操作程序安装变量 部分中的变量指定如何在集群上安装 Cloud Pak for Data 操作程序。

许可证变量

脚本的 许可证变量 部分中的变量指定您购买了哪些许可证。

IBM 授权注册表 变量

脚本的 IBM 授权注册表 变量 部分中的变量使您能够连接到 IBM 授权注册表 ，并访问您有权使用的 Cloud Pak for Data 软件映像。

根据您是从 IBM 授权注册表 还是从专用容器注册表中拉取映像，这些变量还可能用于配置全局映像拉取私钥。

CASE 包管理变量

脚本的 CASE 包管理变量 部分中的变量指定保存 CASE 包的位置。

专用容器注册表变量

强烈建议您使用专用容器注册中心。 仅当您 将映像镜像到专用容器注册表时，才需要 专用容器注册表变量 部分中的变量。

如果您使用中间容器注册表来将映像镜像到专用容器注册表，那么还必须更新脚本的 中间容器注册表变量 部分中的变量。 有关详细信息，请参阅 中间容器注册表变量。

通过脚本的 专用容器注册表变量 部分中的变量，您可以将映像从 IBM 授权注册表 镜像到专用容器注册表。

中间容器注册表变量

仅当您使用 中间容器注册表 将映像镜像到专用容器注册表时，此部分中的变量才是必需的。