安装Wazi Deploy

Wazi Deploy 作为 Python 包提供，允许在多个操作系统上使用。 该软件包必须安装在 Python 中才能正常工作。 在 z/OS® 环境 (在 z/OS UNIX System Services 文件系统中) 或分布式环境 (x86 或 Linux® on Z) 上安装 Wazi Deploy 核心包。

注意：如果您安装的Wazi Deploy版本早于3.0.3，请按照安装3.0.3之前的 Wazi Deploy 中的说明进行操作。

安装必要条件和 Wazi Deploy

注: 以下步骤要求您在 (z/OS) UNIX 命令行上处于活动状态。 在 z/OS中，可以使用 OMVS TSO 命令。 要返回到 TSO，请使用 exit 命令。
  1. 如果在 z/OS上安装，请设置环境变量。
    命令 shell 必须能够找到 Python 可执行文件。 在 z/OS上，命令 shell 还必须允许不是 EBCDIC 编码的脚本。 要执行此操作，必须使用以下命令来设置环境变量:
    export PYTHONHOME=/usr/lpp/IBM/cyp/pyz
export PATH=$PYTHONHOME/bin:$PATH
export _BPXK_AUTOCVT=ON
  2. 如果在 z/OS上安装，请创建 Python 虚拟环境。

    建议创建虚拟环境以隔离 Python 软件包安装。 然后，您可以管理不同项目的单独软件包安装，并测试安装。

    要在 /global/opt/pyenv 目录中创建名为 gdp 的虚拟环境，请输入以下命令:
    python3 -m venv /global/opt/pyenv/gdp
    接下来，必须使用以下命令来激活虚拟环境:
    . /global/opt/pyenv/gdp/bin/activate
    注: 如果使用 bash shell ，那么可以使用 source 命令而不是 . 命令。 例如，您可以输入以下命令:
    source /global/opt/pyenv/gdp/bin/activate
  3. 获取 z/OS上存在的 Wazi Deploy 可安装文件。

    这些文件是通过 SMP/E 安装 Wazi Deploy FMID 时在 z/OS 上创建的，如 Wazi Deploy 程序目录中所述。

    缺省情况下， SMP/E 安装创建了 /usr/lpp/IBM/gdp z/OS UNIX 目录。 此目录包含可在 z/OS上使用的可安装文件以及包含 wazideploy.tar 文件的 tar 子目录。 可以将 wazideploy.tar 文件发送到分布式环境 (x86 或 Linux on Z) ，以便在该系统上安装 Wazi Deploy 。 您可以使用以下命令从文件中抽取可安装文件:
    tar -xvf wazideploy.tar

    可安装文件是轮文件。 轮文件是 ZIP 格式的归档，具有特殊格式的文件名，后跟 .whl 扩展名。 它包含可安装的预编译 Python 模块。 当前 Python 版本支持此安装方法。

    该/usr/lpp/IBM/gdp目录包含当前支持的每个IBM® Open Enterprise SDK for Python 版本的.whl文件。 下表列出了 Wazi Deploy .whl 文件，可以使用这些文件的环境以及相应版本的 IBM Open Enterprise SDK for Python。
    文件名 执行环境 IBM Open Enterprise SDK for Python 版本
    wazideploy_3.0.4-py3.13-none-any.whl z/OS 和分布式 (x86 或 Linux on Z) 环境 3.13
    wazideploy_3.0.4-py3.12-none-any.whl z/OS 和分布式 (x86 或 Linux on Z) 环境 3.12
    wazideploy_3.0.4-py3.11-none-any.whl z/OS 和分布式 (x86 或 Linux on Z) 环境 3.11
    wazideploy_3.0.4-py3.10-none-any.whl z/OS 和分布式 (x86 或 Linux on Z) 环境 3.10
    wazideploy_3.0.4-py3.9-none-any.whl z/OS 和分布式 (x86 或 Linux on Z) 环境 3.9
    wazideploy_3.0.4-py3.8-none-any.whl 分布式 (x86 或 Linux on Z) 环境 3.8
    警告: Python 轮安装方法对 .whl 文件名执行版本匹配。 对文件名的任何修改都可能破坏安装。
  4. 安装必要条件。

    该/usr/lpp/IBM/gdp目录包含一个dependencies目录，其中包含Wazi Deploy 所需的所有上游库。

    在解压缩.tar文件的文件夹中，发出以下命令：
    pip3 install --no-deps --no-cache-dir -r dependencies/requirements.txt --no-index --find-links dependencies
  5. 安装 Wazi Deploy。

    既然Python可以访问必要的库，您就可以在z/OS或分布式环境x86或Linuxon Z）上安装Wazi Deploy。

    输入以下安装命令，其中X代表Wazi Deploywheel 文件中的Python版本。 例如，滚轮文件可以是 wazideploy-3.0.4-py3.10-none-any.whl。

    pip3 install --no-deps --no-cache-dir wazideploy-3.0.4-py3.X-none-any.whl
    注: 如果您不是要安装 Wazi Deploy的环境的管理员，并且未在虚拟环境中安装 Wazi Deploy ，那么 Wazi Deploy 二进制文件将安装在主文件夹 ($HOME/.local/bin) 中。 在这种情况下，在验证 Wazi Deploy 安装之前，必须使用以下命令将此文件夹添加到 PATH 环境变量:
    export PATH=$PATH:$HOME/.local/bin
  6. 验证 Wazi Deploy 安装。
    要执行此操作，请通过使用以下命令触发各种 CLI 模块的帮助选项来验证是否正确安装了所有 Wazi Deploy 命令行界面 (CLI) 模块:
    • wazideploy-package -h
    • wazideploy-generate -h
    • wazideploy-deploy -h
      注: 此命令 (wazideploy-deploy -h) 在 Linux上不起作用。
    • wazideploy-evidence -h

    所有这些命令都必须显示命令参数。

结果

如果您计划使用直接以 z/OS 环境为目标的 Python进行部署，那么现在已完成安装。

但是，如果您打算使用 Ansible® 进行部署，则必须按照安装Wazi Deploy Ansible 集合的说明进行操作。