【Ansible Tower／AWX】awxkitのインストール方法(オンライン・オフライン)

Ansible AWX（Tower）の便利ツール「awxkit」をオンライン、オフラインのそれぞれの環境でインストールする方法を解説します。

環境
オンライン環境でのインストール方法
オフライン環境でのインストール方法

環境

インストールを行う環境構成になります。

OS：AlmaLinux8.4（Windows10のVirtualBox上に構築したもの）
ミドル
- Ansible AWX 15.0.1
- Python 3.6.8

オンライン環境でのインストール方法

オンライン環境でインストールする方法を説明します。

オンライン環境でのインストール方法は簡単で、pip3コマンドを実行すれば自動的にインストールされます。

[root@localhost ~]# pip3 install awxkit
WARNING: Running pip install with root privileges is generally not a good idea. Try `pip3 install --user` instead.
Collecting awxkit
  Downloading https://files.pythonhosted.org/packages/ac/2d/be92e3ea35a58e58a5e5644578e97aa120ae055cf915f618ca2f997d8942/awxkit-18.0.0-py3-none-any.whl (112kB)
    100% |????????????????????????????????| 122kB 4.3MB/s
Requirement already satisfied: requests in /usr/local/lib/python3.6/site-packages (from awxkit)
Requirement already satisfied: PyYAML in /usr/lib64/python3.6/site-packages (from awxkit)
Requirement already satisfied: certifi>=2017.4.17 in /usr/local/lib/python3.6/site-packages (from requests->awxkit)
Requirement already satisfied: charset-normalizer~=2.0.0; python_version >= "3" in /usr/local/lib/python3.6/site-packages (from requests->awxkit)
Requirement already satisfied: urllib3<1.27,>=1.21.1 in /usr/local/lib/python3.6/site-packages (from requests->awxkit)
Requirement already satisfied: idna<4,>=2.5; python_version >= "3" in /usr/local/lib/python3.6/site-packages (from requests->awxkit)
Installing collected packages: awxkit
Successfully installed awxkit-18.0.0

実行結果の最後に「Successfully installed awxkit-18.0.0」と出力されれば、インストールは完了です。

インストールが成功しても、正常に動作しない場合があるので、簡単に動作確認を行います。

下記のように「awx config」コマンドを実行します。

[root@localhost ~]# awx config
{
     "base_url": "＜Web画面のURL＞",
     "token": "",
     "use_sessions": false,
     "credentials": {
          "default": {
               "username": "＜管理者ユーザー名＞",
               "password": "＜管理者パスワード＞"
          }
     }
}

上記のように、AWXの設定情報が表示されれば、正常に動作しています。

リンク

オフライン環境でのインストール方法

オフライン環境でインストールする方法を説明します。

まず、インストールするパッケージ群のダウンロードを行います。
下記の記事を参考にしてダウンロードして下さい。
記事中の「Python Package Index(PyPI)」で必要なパッケージは一通り揃うかなと思います。

インストールに必要なパッケージは下記になります。
AlmaLinux8.4以外のOSだと要求されるパッケージが異なるかもしれません。

PyYAML-6.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl
awxkit-18.0.0-py3-none-any.whl
certifi-2022.6.15-py3-none-any.whl
charset_normalizer-2.0.12-py3-none-any.whl
idna-3.3-py3-none-any.whl
requests-2.27.1-py2.py3-none-any.whl
urllib3-1.26.11-py2.py3-none-any.whl

FTPクライアント（FFFTP・WinScpなど）でダウンロードしたパッケージをawxkitをインストールするサーバーに転送して下さい。

転送後、pip3コマンドでインストールを行います。
コマンドは、パッケージが格納されているディレクトリで実行して下さい。

[root@localhost ~]# pip3 install --no-deps *.whl
WARNING: Running pip install with root privileges is generally not a good idea. Try `pip3 install --user` instead.
Processing ./PyYAML-6.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.manylinux_2_12_x86_64.manylinux2010_x86_64.whl
Processing ./awxkit-18.0.0-py3-none-any.whl
Processing ./certifi-2022.6.15-py3-none-any.whl
Processing ./charset_normalizer-2.0.12-py3-none-any.whl
Requirement already satisfied: idna==3.3 from file:///home/download/pkg/idna-3.3-py3-none-any.whl in /usr/local/lib/python3.6/site-packages
Requirement already satisfied: requests==2.27.1 from file:///home/download/pkg/requests-2.27.1-py2.py3-none-any.whl in /usr/local/lib/python3.6/site-packages
Processing ./urllib3-1.26.11-py2.py3-none-any.whl
Installing collected packages: PyYAML, awxkit, certifi, charset-normalizer, urllib3
  Found existing installation: certifi 2021.10.8
    Uninstalling certifi-2021.10.8:
      Successfully uninstalled certifi-2021.10.8
  Found existing installation: charset-normalizer 2.0.10
    Uninstalling charset-normalizer-2.0.10:
      Successfully uninstalled charset-normalizer-2.0.10
  Found existing installation: urllib3 1.26.8
    Uninstalling urllib3-1.26.8:
      Successfully uninstalled urllib3-1.26.8
Successfully installed PyYAML-6.0 awxkit-18.0.0 certifi-2022.6.15 charset-normalizer-2.0.12 urllib3-1.26.11

実行結果の最後に「Successfully installed PyYAML-6.0 awxkit-18.0.0 certifi-2022.6.15 charset-normalizer-2.0.12 urllib3-1.26.11」と出力されれば、インストールは完了です。

インストールが成功しても、正常に動作しない場合があるので、簡単に動作確認を行います。

下記のように「awx config」コマンドを実行します。

[root@localhost ~]# awx config
{
     "base_url": "＜Web画面のURL＞",
     "token": "",
     "use_sessions": false,
     "credentials": {
          "default": {
               "username": "＜管理者ユーザー名＞",
               "password": "＜管理者パスワード＞"
          }
     }
}

上記のように、AWXの設定情報が表示されれば、正常に動作しています。

リンク