Skip to content

Commit 98ab2c0

Browse files
rlopez133rlopez133
authored
Merge pull request #2298 from rlopez133/issue_1897
updating exercise 9 so its AAP 2.x
2 parents 71cd4fc + 5f7fba9 commit 98ab2c0

File tree

11 files changed

+153
-203
lines changed

11 files changed

+153
-203
lines changed

‎exercises/ansible_windows/9-win-workflow/README.ja.md‎

Lines changed: 78 additions & 104 deletions
Original file line numberDiff line numberDiff line change
@@ -1,148 +1,122 @@
1-
この手順は、すでにまとめたものをすべてワークフローと呼ばれるもので使用するように設計されています。
1+
# Ansible ワークフローの作成
22

3-
ワークフローはエンドツーエンドの自動化オーケストレーションプロセスと考えることができます。これにより、自動化プレイおよびロールを論理フローにリンクして何かを行うことができます。
3+
この演習では、**Ansible Automation Platform (AAP) 2.x** の **Automation Controller ワークフロー** を作成します。
4+
ワークフローとは、ジョブテンプレート（および他のノード）を条件付きパスで論理的にリンクするエンドツーエンドのオーケストレーションです。
45

5-
今回のケースでは、以下のような流れになります。選択された最新の Windows アップデートをインストールします。 IIS のインストール (アドバンス
6-
ロール) を行います。追加パッケージをインストール (chocolatey を使用) します。最後に chocolatey ファクトと設定を確認します。
6+
今回のフローは以下の通りです。
77

8-
また、基本的な条件付きロジックを設定し、うまくいかない場合にはロールバック機能などを利用することもできます。
8+
- 選択した最新の Windows 更新プログラムをインストール
9+
- IIS をインストール（高度なロールを使用）
10+
- Chocolatey を使って追加パッケージをインストール
11+
- 最後に Chocolatey のファクトと設定を確認
912

10-
セクション 1 - ワークフローの作成
11-
===============================================
13+
条件付きロジック（成功時／失敗時／常時実行）やロールバックパスを追加することも可能です。
14+
以下の手順は **AAP 2.5 UI** に基づいています。
1215

13-
新しいワークフローテンプレートを作成し、そこに既存のオートメーションを追加していきます。
16+
## セクション 1 — ワークフローの作成
1417

15-
終了時には、以下のようになります。
18+
**Workflow Job Template** を作成し、既存のジョブテンプレートをノードとして追加します。
1619

17-
![ワークフローの例](images/9-win-workflow-0.png)
20+
完成形は次のようになります。
1821

19-
ステップ 1:
20-
---------------
22+
![Workflow Example](images/9-win-workflow-0.png)
2123

22-
*Template* に移動し、*Add* をクリックして `Workflow Template`
23-
を選択し、新しいワークフローテンプレートを作成します。
24+
### ステップ 1 — 新しいワークフローテンプレート
2425

25-
次の値を使用してフォームに記入します
26+
1. AAP Web UI で **Automation Execution → Templates** に移動します。
27+
**Create template** をクリックし、**Create workflow job template** を選択します。
2628

27-
| Key | Value | Note |
28-
|--------------------|----------------------------|------|
29-
| NAME | Example Workflow | |
30-
| DESCRIPTION | End-to-end process | |
31-
| ORGANIZATION | Default | |
32-
| INVENTORY | Windows Workshop Inventory | |
33-
| LIMIT | windows | |
29+
2. 次の値でフォームを入力します。
3430

35-
![ワークフローテンプレートの作成](images/9-win-workflow-1.png)
31+
| キー | 値 | 備考 |
32+
|-----------------|-----------------------------|------|
33+
| **Name** | Example Workflow | |
34+
| **Description** | End-to-end process | |
35+
| **Organization**| Default | |
36+
| **Inventory** | Windows Workshop Inventory | |
37+
| **Limit** | windows | |
3638

37-
SAVE ![保存](images/at_save.png) をクリックすると、ワークフロービジュアライザーに入ります。
39+
![Create Workflow Template](images/9-win-workflow-1.png)
3840

39-
ステップ 2:
40-
---------------
41+
3. **Create workflow job template** をクリックします。**Workflow Visualizer** が表示されます。（終了した場合は、テンプレートの **Details** ページから再度開くことができます。）
4142

42-
スタートボックスをクリックし、右側の選択項目から**Windows Update**を選びます。
43+
### ステップ 2 — 最初のジョブテンプレート（Windows Updates）の追加
4344

44-
以下のプロパティーを選択します。
45+
1. **Add step** ボタンをクリックし、右側パネルから **Windows Updates** ジョブテンプレートを選択します。
46+
2. 次の設定を行います。
4547

46-
| Key | Value | Note |
47-
|--------------------|----------------------------|------|
48-
| RUN | Always | |
49-
| CONVERGENCE | Any | |
48+
| キー | 値 | 備考 |
49+
|-------------------|------------------|------|
50+
| **Node Type** | Job Template | |
51+
| **Job template** | Windows Updates | |
52+
| **Convergence** | Any | |
5053

51-
![最初のノードの追加](images/9-win-workflow-2.png)
54+
![Add First JT](images/9-win-workflow-2.png)
5255

53-
ポップアップで Prompt、Next、および Confirm をクリックします。
54-
55-
メインビジュアライザー画面に戻り、Select をクリックします。
56+
3. **Next** をクリックし、次に **Finish** をクリックします。
57+
4. ビジュアライザーで 3 点リーダーをクリックし、**Add Step and link** を選択します。
5658

5759
![Workflow Visualizer1](images/9-win-workflow-3.png)
5860

59-
ワークフローの第一段階を追加しました。
60-
61-
**Windows Update** ボックスにカーソルを合わせ、緑色の + をクリックします。
61+
### ステップ 3 — IIS Advanced ジョブテンプレートの追加
6262

63-
次のステップで、**IIS Advanced** テンプレートを選択します。
63+
1. **IIS Advanced** ジョブテンプレートを選択します。
64+
2. 次の設定を行います。
6465

65-
以下のプロパティーを選択します。
66-
67-
| Key | Value | Note |
68-
|--------------------|----------------------------|------|
69-
| RUN | Always | |
70-
| CONVERGENCE | Any | |
66+
| キー | 値 | 備考 |
67+
|-------------------|-----------------|------|
68+
| **Node type** | Job Template | |
69+
| **Job template** | IIS Advanced | |
70+
| **Status** | Always run | |
71+
| **Convergence** | Any | |
7172

7273
![Workflow Visualizer2](images/9-win-workflow-4.png)
7374

74-
プロンプトをクリックします。
75-
76-
メッセージを Created in our workflow example (または同様の表現) に変更し、ポップアップで Next と
77-
Confirm を押します。
78-
79-
メインビジュアライザー画面に戻り、Select をクリックします。
80-
81-
![Workflow Visualizer3](images/9-win-workflow-5.png)
82-
83-
現在、2 段階のプロセスを採用しています。まず、Windows のアップデートを行い、その後、アップデートがうまくいくか **どうかにかかわらず**
84-
IIS
85-
の詳細インストールを行います。更新がうまくいくかどうかはこの時点では気にしないかもしれませんが、誰かに警告するために失敗したときに通知が発せられるように設定できます。
86-
87-
その他にもアプリケーションデプロイメントの一部を表現してみましょう。
88-
89-
**IIS Advanced** ボックスにカーソルを合わせ、緑色の + をクリックします。
90-
91-
次のステップで、**Chocolatey - Install Packages** テンプレートを選択します。
92-
93-
以下のプロパティーを選択します。
94-
95-
| Key | Value | Note |
96-
|--------------------|----------------------------|------|
97-
| RUN | On Success | |
98-
| CONVERGENCE | Any | |
99-
100-
![Workflow Visualizer4](images/9-win-workflow-6.png)
101-
102-
メインビジュアライザー画面に戻り、Select をクリックします。
103-
104-
**Chocolatey - Install Packages** ボックスにカーソルを合わせ、緑色の + をクリックします。
75+
4. **Next** → **Finish** をクリックします。
10576

106-
次のボックスで、**Chocolatey - Facts and configuration** テンプレートを選択します。
77+
これで、**Windows Updates** → **IIS Advanced** の 2 段階プロセスになりました。IIS は更新結果に関係なく実行されます。（後で失敗時の通知を追加できます。）
10778

108-
以下のプロパティーを選択します。
79+
### ステップ 4 — Chocolatey ステップの追加
10980

110-
| Key | Value | Note |
111-
|--------------------|----------------------------|------|
112-
| RUN | On Success | |
113-
| CONVERGENCE | Any | |
81+
1. **IIS Advanced** 上にマウスを置き、3 点リーダーをクリックして **Add step and link** を選択し、**Chocolatey – Install Packages** を選択します。
82+
設定は以下の通りです。
11483

115-
**選択** をクリックします。
84+
| キー | 値 | 備考 |
85+
|-------------------|------------------------------|------|
86+
| **Node type** | Job Template | |
87+
| **Job template** | Chocolatey - Install Packages| |
88+
| **Status** | Run on success | |
89+
| **Convergence** | Any | |
11690

117-
![Workflow Visualizer5](images/9-win-workflow-7.png)
91+
![Workflow Visualizer4](images/9-win-workflow-5.png)
11892

119-
**保存** をクリックします。
93+
2. **Next** → **Finish** をクリックします。
94+
3. **Chocolatey – Install Packages** 上にマウスを置き、3 点リーダーをクリックして **Add step and link** を選択し、**Chocolatey – Facts and configuration** を選びます。
95+
設定は以下の通りです。
12096

121-
テンプレート画面に戻ります。ここで **保存** をクリックします。
97+
| キー | 値 | 備考 |
98+
|-------------------|-------------------------------------|------|
99+
| **Node type** | Job Template | |
100+
| **Job template** | Chocolatey - Facts and configuration| |
101+
| **Status** | Run on success | |
102+
| **Convergence** | Any | |
122103

123-
セクション 2: 新しいワークフローの実行
124-
=======================================================
104+
4. **Next** → **Finish** をクリックします。
125105

126-
それを実行して、どのように機能するかを見てみましょう。
106+
![Workflow Visualizer5](images/9-win-workflow-6.png)
127107

128-
ステップ 1:
129-
---------------
108+
5. ビジュアライザーで **Save** をクリックしてフローを保存します。
130109

131-
テンプレートを選択します
110+
![Workflow Visualizer Save](images/9-win-workflow-7.png)
132111

133-
> **注意**
134-
>
135-
> あるいは、テンプレートから移動していない場合
136-
> 作成ページでは、下にスクロールして既存のすべてのテンプレートを表示できます
112+
## セクション 2 — ワークフローの実行
137113

138-
ステップ 2:
139-
---------------
114+
1. 左ナビゲーションから **Automation Execution → Templates** に移動します。
115+
2. **Example Workflow** の **ロケット（Launch）** アイコンをクリックして開始します。テンプレートを開き、**Launch template** をクリックすることもできます。
140116

141-
ワークフローテンプレート **Example Workflow** のロケットシップアイコン
142-
![Add](images/at_launch_icon.png) をクリックします。
117+
各ノードの実行結果がリアルタイムで表示されます。
143118

144-
ワークフローの起動後は、ワークフローの出力をリアルタイムで確認できます。
119+
すべてが正常に動作すれば、結果は次のようになります。
145120

146-
すべてが正常に終了すると、以下のような出力が表示されるはずです。
121+
![Workflow Visualizer](images/9-win-workflow-8.png)
147122

148-
![Workflow Visualizer6](images/9-win-workflow-8.png)

0 commit comments

Comments
 (0)