Merge pull request #359 from ansible/devel

Devel

Author: IPvSean

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)

_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"

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)

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)

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

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 %}

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)

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 グループが一覧となります。
 

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)

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 モジュールのドキュメンテーションで確認できます。