コマンドライン・インタフェースの操作

6 コマンドライン・インタフェースの操作

コマンドライン・インタフェースを使用して、コレクションおよび実行可能ロールを管理できます。

コマンドライン・インタフェースのインストール

コマンドライン・インタフェースは、Private Automation Hubインストーラをインストールすると、Private Automation Hubデプロイメント・ホストにインストールされます。 Private Automation Hubのインストールの詳細は、「Oracle Linux Automation Manager 2: Private Automation Hubインストレーション・ガイド」を参照してください。また、デプロイメント・ホストでCLIを使用するのではなく、別のシステムにCLIのみをインストールすることもできます。

別のシステムにCLIだけをインストールするには、次を実行します:

dnf config-managerツールを使用して、yumリポジトリを有効にし、次のいずれかを実行します:
- ol8_UEK6を使用している場合は、次のコマンドを使用します:
```
sudo dnf config-manager --enable ol8_UEKR6 ol8_appstream
```
- ol8_UEK7を使用している場合は、次のコマンドを使用します:
```
sudo dnf config-manager --enable ol8_UEKR7 ol8_appstream
```
ansibleのバージョンがシステムに存在しないことを確認します。これらがあればアンインストールします。たとえば、ansibleのバージョンがインストールされていないことを示しています:
```
rpm -q ansible
package ansible is not installed
```
CLIをインストールします:
```
sudo dnf install ansible-core
```

コマンド・ライン・インタフェースの使用

一連のオプションでコマンドを入力して、CLIと対話します。 --helpフラグを指定したCLIコマンドは、次の構文情報を返します:

ansible-galaxy --help
usage: ansible-galaxy [-h] [--version] [-v] TYPE ...

Perform various Role and Collection related operations.

positional arguments:
  TYPE
    collection   Manage an Ansible Galaxy collection.
    role         Manage an Ansible Galaxy role.

options:
  --version      show program's version number, config file location, configured module search path, module location, executable location and exit
  -h, --help     show this help message and exit
  -v, --verbose  Causes Ansible to print more debug messages. Adding multiple -v will increase the verbosity, the builtin plugins currently evaluate up to -vvvvvv. A
                 reasonable level to start is -vvv, connection debugging might require -vvvv.

「定位置引数」セクションには、CLIを使用して管理できるリソースがリストされます。これらのリソースに関する追加情報を取得するには、--helpフラグの前にリソース名を追加します。たとえば、コレクション・リソースで使用可能なアクションを次に示します:

ansible-galaxy collection --help
usage: ansible-galaxy collection [-h] COLLECTION_ACTION ...

positional arguments:
  COLLECTION_ACTION
    download         Download collections and their dependencies as a tarball
                     for an offline install.
    init             Initialize new collection with the base structure of a
                     collection.
    build            Build an Ansible collection artifact that can be
                     published to Ansible Galaxy.
    publish          Publish a collection artifact to Ansible Galaxy.
    install          Install collection(s) from file(s), URL(s) or Ansible
                     Galaxy
    list             Show the name and version of each collection installed in
                     the collections_path.
    verify           Compare checksums with the collection(s) found on the
                     server and the installed copy. This does not verify
                     dependencies.

options:
  -h, --help         show this help message and exit

次に、ロール・リソースで使用可能なアクションを示します:

ansible-galaxy role --help
usage: ansible-galaxy role [-h] ROLE_ACTION ...

positional arguments:
  ROLE_ACTION
    init       Initialize new role with the base structure of a role.
    remove     Delete roles from roles_path.
    delete     Removes the role from Galaxy. It does not remove or alter the actual GitHub repository.
    list       Show the name and version of each role installed in the roles_path.
    search     Search the Galaxy database by tags, platforms, author and multiple keywords.
    import     Import a role into a galaxy server
    setup      Manage the integration between Galaxy and the given source.
    info       View more details about a specific role.
    install    Install role(s) from file(s), URL(s) or Ansible Galaxy

options:
  -h, --help   show this help message and exit

同様の方法で、--helpフラグを使用して、使用可能なアクションに関する追加情報を取得できます。