4.5. ロールの作成とロールの説明の表示

手順

1. Red Hat アカウントで VS Code にログインします。
2. Activity バーから、Ansible アイコンをクリックします。

3. ロールを作成するには、次のいずれかの方法を使用します。

   • Ansible パネルから:

     1. ナビゲーションメニューから、Ansible アイコンをクリックします。
     2. Generate a role をクリックします。

   • コマンドパレットから:

     • VS Code エディターのコマンドパレットで、View Command Palette をクリックし、> Ansible Lightspeed: Role generation と入力します。

       VS Code 画面の右側のパネルに、Create a role with Ansible Lightspeed ページが表示されます。

4. Select the collection to create role in リストから、ロールを作成するコレクションを選択します。ロールを作成するには、ワークスペース内にコレクションが必要です。

   コレクションがない場合は、次のいずれかの方法でコレクションを作成する必要があります。

   • 次のコマンドを使用します。

     ansible-creator init collection myns.mycollection my_directory

     コマンドを実行した後、VS Code で新しいディレクトリーを開きます。

   • Ansible VS Code 拡張機能を使用します。

     詳細は、Ansible Automation Platform のスタート ガイドの コンテンツコレクションについて のトピックを参照してください。

5. Describe what you want to achieve in natural language フィールドで、ロールを作成するためのプロンプトを入力し、Analyze をクリックします。

   数秒後、ロールの目的に応じた推奨手順が Review the suggested steps for your role and modify as needed フィールドに表示されます。

6. 次のタスクを実行します。

   1. ロール名を確認し、必要に応じて変更します。
   2. ロールが作成されるコレクションを確認します。

   3. 推奨の手順が目的と一致していることを確認し、Continue をクリックします。

      ロールの生成には数秒かかり、ロールの生成先のファイルリストとともに、新たに生成されたロールが表示されます。

      注記
      • 手順を変更する場合: エディターフィールドをクリックし、目的に合わせてプロンプトまたは手順を更新して、Continue をクリックします。
      • 推奨のロールが目的に合っていない場合は、Back をクリックし、元のプロンプトを変更してやり直してください。
      • 元の推奨手順に戻す場合は、Reset をクリックし、Continue をクリックして次の手順に進みます。
7. Save files をクリックします。新しいロールを含むファイルのリストが表示されます。
8. ファイルをクリックして、VS Code エディターで直接開きます。

手順

1. Red Hat アカウントで VS Code にログインします。
2. VS Code の roles ディレクトリー内で Ansible ロール YAML ファイルを開きます。

3. 次のいずれかの方法を使用して Playbook の説明を表示します。

   • アクティブなロールの YAML ファイルから:

     1. Playbook ファイル内の任意の場所にカーソルを置きます。
     2. 右クリックして、Explain the role with Ansible Lightspeed を選択します。

   • Ansible パネルから:

     1. ナビゲーションメニューから、Ansible アイコンをクリックします。
     2. Explain the current playbook を選択します。

   • コマンドパレットから:

     • VS Code エディターのコマンドパレットから、Explain the role with Ansible Lightspeed と入力します。

       VS Code 画面の右側のパネルにロールの説明が表示されます。

       次の図は、ロールの説明の例を示しています。

       図4.7 ロールの説明の例