Merge pull request #359 from ansible/devel

Devel
ansible · Aug 6, 2019 · a9b9a2b · a9b9a2b
2 parents ce3a69a + 5b7b0e0
commit a9b9a2b
Show file tree

Hide file tree

Showing 65 changed files with 960 additions and 353 deletions.
diff --git a/README.md b/README.md
@@ -16,7 +16,15 @@ The Red Hat Ansible Automation Workshops project is intended for effectively dem
 
 # SELF-PACED EXERCISES:
 
-  * [Vagrant Demo](vagrant-demo) - Self-paced networking exercises that can be run on your personal laptop
+ - [Vagrant Demo](vagrant-demo) - Self-paced networking exercises that can be run on your personal laptop
+
+# DOCUMENTATION:
+
+ - [How to contribute](docs/contribute.md)
+ - [How to use the AWS Lab Provisioner](provisioner/README.md)
+ - [FAQ](docs/faq.md)
+
+
 
 ---
 ![Red Hat Ansible Automation](images/rh-ansible-automation.png)
diff --git a/_config.yml b/_config.yml
@@ -1,6 +1,8 @@
 theme: jekyll-theme-dinky
-exclude:
-  - "*.yml"
-  - "*.yaml"
 include:
-  - "exercises/ansible_network/2-first-playbook/router_configs.yml"
+  - "provisioner/README.md"
+exclude:
+  - "demos/*"
+  - "provisioner/roles"
+  - "provisioner/group_vars"
+  - "provisioner/inventory"
diff --git a/docs/contribute.md b/docs/contribute.md
@@ -7,32 +7,39 @@ We take pull requests!  What is a pull request?
 More info on PRs: [https://help.github.com/en/articles/about-pull-requests](https://help.github.com/en/articles/about-pull-requests)
 
 ## Create a fork!
+
 Create a fork on your own Github project (or your personal space)
 
 [Github Documentation on Forking a repo](https://help.github.com/articles/fork-a-repo/)
 
 ## Stay in Sync
+
 It is important to know how to keep your fork in sync with the upstream Workshops project.
 
 ### Configuring Your Remotes
+
 Configure `ansible/workshops` as your upstream so you can stay in sync
 
 ```bash
 git remote add upstream https://github.com/ansible/workshops.git
 ```
 
 ### Rebasing Your Branch
-Three step process
+
+Rebase the branch on your fork
 
 ```bash
-git pull --rebase upstream master
+git pull --rebase upstream devel
 ```
 
+Check your status 
+
 ```bash
 git status
 ```
 
 ### Updating your Pull Request
+
 ```bash
 git push --force
 ```
@@ -41,6 +48,8 @@ More info on docs.ansible.com: [Rebasing a Pull Request](http://docs.ansible.com
 
 ## Create a pull requests
 
+**PULL REQUESTS MUST BE MADE INTO THE `DEVEL` BRANCH**
+
 Make sure you are not behind (in sync) and then submit a PR to the Ansible Workshops.  
 [Read the Pull Request Documentation on Github.com](https://help.github.com/articles/creating-a-pull-request/)
 
@@ -53,6 +62,7 @@ Just because you submit a PR, doesn't mean that it will get accepted.  Right now
 Being more descriptive is better, and has a higher change of getting merged upstream.  Communication is key!  Just b/c the PR doesn't get accepted right away doesn't mean it is not a good idea. Ansible Workshops have to balance many different types of users.  Thank you for contributing!
 
 # Going Further
+
 The following links will be helpful if you want to contribute code to the Ansible Workshops project, or any Ansible project:
 - [Ansible Committer Guidelines](http://docs.ansible.com/ansible/latest/committer_guidelines.html)
 - [Learning Git](https://git-scm.com/book/en/v2)
diff --git a/exercises/ansible_f5/1.0-explore/README.ja.md b/exercises/ansible_f5/1.0-explore/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.0 - 演習環境の確認
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 演習を開始する前にぜひ Ansible Slack へ参加してください！(任意)
 
 - [クリックして ansiblejp slack (日本語) へ参加](https://bit.ly/slack-ansiblejp)

diff --git a/exercises/ansible_f5/1.0-explore/README.md b/exercises/ansible_f5/1.0-explore/README.md
@@ -1,5 +1,7 @@
 ### Exercise 1.0: Exploring the lab environment
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 Before you get started, please join us on slack! [Click here to join the ansiblenetwork slack](https://join.slack.com/t/ansiblenetwork/shared_invite/enQtMzEyMTcxMTE5NjM3LWIyMmQ4YzNhYTA4MjA2OTRhZDQzMTZkNWZlN2E3NzhhMWQ5ZTdmNmViNjk2M2JkYzJjODhjMjVjMGUxZjc2MWE).  This will allow you to chat with other network automation engineers and get help after the workshops concludes.
 
 #### Step 1

diff --git a/exercises/ansible_f5/1.1-get-facts/README.ja.md b/exercises/ansible_f5/1.1-get-facts/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.1 - Ansible による F5 BIG-IP の情報収集
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)
@@ -90,7 +92,7 @@ Ansible の playbook は **YAML** ファイルです。YAML は構造化され
 
 ## Step 4
 
-次に2つ目の `task` を追加します。 このタスクでは `debug` モジュールを使って、register 
+次に2つ目の `task` を追加します。 このタスクでは `debug` モジュールを使って、register
 された `bigip_device_facts variable` 変数の値を出力します。
 
 {% raw %}

diff --git a/exercises/ansible_f5/1.1-get-facts/README.md b/exercises/ansible_f5/1.1-get-facts/README.md
@@ -1,5 +1,7 @@
 # Exercise 1.1: Using the bigip_device_facts module
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/1.2-add-node/README.ja.md b/exercises/ansible_f5/1.2-add-node/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.2 - ノードの追加
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)
@@ -25,7 +27,7 @@
 
 ## Step 2:
 
-以下の定義を `bigip-node.yml` に入力します : 
+以下の定義を `bigip-node.yml` に入力します :
 
 ``` yaml
 ---
@@ -73,12 +75,12 @@
 
 - `name: CREATE NODES` ：　ユーザーが定義する説明文です。これは実行時に端末に表示されることになります。
 - `bigip_node:` ：　使用するモジュールを宣言しています。  `loop` を除く全てのものは、モジュールのドキュメント上で定義されている、モジュールパラメータです。
-- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。 
+- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。
 - `user: "{{ansible_user}}"` ：　BIG-IP へログインするユーザー名を指定します。
-- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。 
+- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。
 - `server_port: 8443` ：　BIG-IPへ接続する際のポート番号を指定します。
 - `host: "{{hostvars[item].ansible_host}}"` ：　モジュールへインベントリに登録済みのWebサーバーのIPアドレスを追加します。
-- `name: "{{hostvars[item].inventory_hostname}}"` ： `inventory_hostname` をホスト名（host1、host2 となります）として使うことを指示します。 
+- `name: "{{hostvars[item].inventory_hostname}}"` ： `inventory_hostname` をホスト名（host1、host2 となります）として使うことを指示します。
 - `validate_certs: "no"` ： （あくまで演習用ラボなので）SSL証明書の検証を行わないように設定します。  
 - `loop:` ：　与えられた一覧に対してタスクをループ実行することを指定します。この演習では、二つのRHELホストを含む webservers グループが一覧となります。
 

diff --git a/exercises/ansible_f5/1.2-add-node/README.md b/exercises/ansible_f5/1.2-add-node/README.md
@@ -1,5 +1,7 @@
 # Exercise 1.2 - Adding nodes to F5 BIG-IP
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/1.3-add-pool/README.ja.md b/exercises/ansible_f5/1.3-add-pool/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.3 - プールの追加
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)
@@ -71,9 +73,9 @@
 
 - `name: CREATE POOL` ：　ユーザーが定義する説明文です。これは実行時に端末に表示されることになります。
 - `bigip_pool:` ： 使用するモジュールを宣言しています。
-- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。 
+- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。
 - `user: "{{ansible_user}}"` ：　BIG-IP へログインするユーザー名を指定します。
-- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。 
+- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。
 - `server_port: 8443` ：　BIG-IPへ接続する際のポート番号を指定します。
 - `name: "http_pool"` ： 作成するプールの名前を指定します。
 - `lb_method: "round-robin"`  ： 負荷分散方式を round-robin に指定します。全ての設定可能な負荷分散方式は bigip_pool モジュールのドキュメンテーションで確認できます。

diff --git a/exercises/ansible_f5/1.3-add-pool/README.md b/exercises/ansible_f5/1.3-add-pool/README.md
@@ -1,5 +1,7 @@
 # Exercise 1.3 - Adding a load balancing pool
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/1.4-add-pool-members/README.ja.md b/exercises/ansible_f5/1.4-add-pool-members/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.4 - メンバーをプールへ追加
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)
@@ -25,7 +27,7 @@
 
 ## Step 2:
 
-`bigip-pool-members.yml` へ、以下のプレイブック定義を記述します : 
+`bigip-pool-members.yml` へ、以下のプレイブック定義を記述します :
 
 ``` yaml
 ---
@@ -72,7 +74,7 @@
 
 - `name: ADD POOL MEMBERS` ：　ユーザーが定義する説明文です。これは実行時に端末に表示されることになります。
 - `bigip_pool_member:` ：　使用するモジュールを宣言しています。
-- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。 
+- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。
 - `user: "{{ansible_user}}"` ：　BIG-IP へログインするユーザー名を指定します。
 - `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。
 - `server_port: 8443` ：　BIG-IPへ接続する際のポート番号を指定します。

diff --git a/exercises/ansible_f5/1.4-add-pool-members/README.md b/exercises/ansible_f5/1.4-add-pool-members/README.md
@@ -1,5 +1,7 @@
 # Exercise 1.4: Adding members to a pool on F5
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/1.5-add-virtual-server/README.ja.md b/exercises/ansible_f5/1.5-add-virtual-server/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.5 - Virtual Server の追加
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)
@@ -27,7 +29,7 @@
 
 Ansible のプレイブックは **YAML** 形式のファイルです。YAMLは構造化されたフォーマットで、非常に読み易いものです。
 
-以下の定義を `bigip-virtual-server.yml` に入力します : 
+以下の定義を `bigip-virtual-server.yml` に入力します :
 
 ``` yaml
 ---
@@ -74,13 +76,13 @@ Ansible のプレイブックは **YAML** 形式のファイルです。YAMLは
 
 {% endraw %}
 
->プレイブックは一連のタスクから成ります。タスクとモジュールは1：1の関係性があります。モジュールは、Ansible API やansible / ansible-playbook から利用可能で、再利用可能なスタンドアロンスクリプトです。実行結果は、JSON文字列として標準出力へ出力されます。 
+>プレイブックは一連のタスクから成ります。タスクとモジュールは1：1の関係性があります。モジュールは、Ansible API やansible / ansible-playbook から利用可能で、再利用可能なスタンドアロンスクリプトです。実行結果は、JSON文字列として標準出力へ出力されます。
 
 - `name: ADD VIRTUAL SERVER` ：　ユーザーが定義する説明文です。これは実行時に端末に表示されることになります。
 - `bigip_virtual_server:` ：　使用するモジュールを宣言しています。
-- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。 
+- `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。
 - `user: "{{ansible_user}}"` ：　BIG-IP へログインするユーザー名を指定します。
-- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。 
+- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。
 - `server_port: 8443` ：　BIG-IPへ接続する際のポート番号を指定します。
 - `name: "vip"` ： vip という名前のVirtual Server を作成することを指定します。
 - `destination"` ： Virtual Server にIPアドレスを指定します。
@@ -153,4 +155,4 @@ Virtual Serverは画面左のメニューから辿ることで確認できます
 ```
 
 
-これで本演習は終わりです。[演習ガイドへ戻る](../README.ja.md)
+これで本演習は終わりです。[演習ガイドへ戻る](../README.ja.md.md)
diff --git a/exercises/ansible_f5/1.5-add-virtual-server/README.md b/exercises/ansible_f5/1.5-add-virtual-server/README.md
@@ -1,5 +1,7 @@
 # Exercise 1.5: Using the bigip_virtual_server module
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/1.6-add-irules/README.ja.md b/exercises/ansible_f5/1.6-add-irules/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.6 - iRules の追加と Virtual Server へのアタッチ
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)
@@ -97,19 +99,19 @@ when HTTP_REQUEST {
 ```
 {% endraw %}
 
->プレイブックは一連のタスクから成ります。タスクとモジュールは1：1の関係性があります。モジュールは、Ansible API やansible / ansible-playbook から利用可能で、再利用可能なスタンドアロンスクリプトです。実行結果は、JSON文字列として標準出力へ出力されます。 
+>プレイブックは一連のタスクから成ります。タスクとモジュールは1：1の関係性があります。モジュールは、Ansible API やansible / ansible-playbook から利用可能で、再利用可能なスタンドアロンスクリプトです。実行結果は、JSON文字列として標準出力へ出力されます。
 
 - 変数 `'irules'` ： ２つのiRules（つまり、'irule1'と'irule2'）を設定します。
 - `name: ADD iRules` ：　ユーザーが定義する説明文です。これは実行時に端末に表示されることになります。
 - `bigip_irule:` ：　使用するモジュールを宣言しています。
 - `server: "{{private_ip}}"` ：　接続先となるBIG-IPのIPアドレスを指定します。これはインベントリ内で `private_ip` として登録されているものです。
 - `user: "{{ansible_user}}"` ：　BIG-IP へログインするユーザー名を指定します。
-- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。 
+- `password: "{{ansible_ssh_pass}}"` ：　BIG-IPへログインする際のパスワードを指定します。
 - `server_port: 8443` ：　BIG-IPへ接続する際のポート番号を指定します。
 - `module: ltm` ： iRulesがBIG-IPのどの機能で使用するかを指定します。本演習では ltm を指定します。
 - `name: "{{item}}"` ：  'irule1'と 'irule2' という名前の iRules を登録することを指定します。
 - `content: "{{lookup('file','{{item}}')}}" ` ： [lookup plugin](https://docs.ansible.com/ansible/latest/plugins/lookup.html)を使って、iRulesに追加するコンテンツを指定します。
-- `validate_certs: "no"` ： （あくまで演習用ラボなので）SSL証明書の検証を行わないように設定します。 
+- `validate_certs: "no"` ： （あくまで演習用ラボなので）SSL証明書の検証を行わないように設定します。
 - `loop:` 与えられた iRules のリストに対してタスクを実行するように指定します。
 
 ## Step 5

diff --git a/exercises/ansible_f5/1.6-add-irules/README.md b/exercises/ansible_f5/1.6-add-irules/README.md
@@ -1,5 +1,7 @@
 # Exercise 1.6: Using the bigip_irule module
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/1.7-save-running-config/README.ja.md b/exercises/ansible_f5/1.7-save-running-config/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 1.7 - コンフィグの保存
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)

diff --git a/exercises/ansible_f5/1.7-save-running-config/README.md b/exercises/ansible_f5/1.7-save-running-config/README.md
@@ -1,5 +1,7 @@
 # Exercise 1.7: Using the bigip_config module
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/2.0-disable-pool-member/README.ja.md b/exercises/ansible_f5/2.0-disable-pool-member/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 2.0 - プールメンバーの無効化
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)
@@ -137,7 +139,7 @@ HINT: Playbook 内で動的に各ファクト情報を簡易設定する方法
 
 ヒント:
 <a href="https://docs.ansible.com/ansible/latest/user_guide/playbooks_conditionals.html" style="color: #000000"> when による条件分岐とループ </a> と [BIG-IP pool member module](https://docs.ansible.com/ansible/latest/modules/bigip_pool_member_module.html)を参照してください。
-  
+
 ## Step 10
 Playbook の実行 - コントロールホストへ戻り、以下のコマンドを実行します:
 

diff --git a/exercises/ansible_f5/2.0-disable-pool-member/README.md b/exercises/ansible_f5/2.0-disable-pool-member/README.md
@@ -1,5 +1,7 @@
 # Exercise 2.0 - Disabling a pool member
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)

diff --git a/exercises/ansible_f5/2.1-delete-configuration/README.ja.md b/exercises/ansible_f5/2.1-delete-configuration/README.ja.md
@@ -1,5 +1,7 @@
 # 演習 2.1 - モジュールの組み合わせを使用してBIG-IPの構成を削除する
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## 目次
 
 - [目的](#目的)

diff --git a/exercises/ansible_f5/2.1-delete-configuration/README.md b/exercises/ansible_f5/2.1-delete-configuration/README.md
@@ -1,5 +1,7 @@
 # Exercise 2.1: Using a combination of modules to delete configuration on the BIG-IP
 
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+
 ## Table of Contents
 
 - [Objective](#objective)