Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add link to Japanese page and minor update #814

Merged
merged 4 commits into from
May 3, 2020
Merged

Add link to Japanese page and minor update #814

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
18aeaee
Add link for japanese
senmm May 3, 2020
9c4ed78
update readmme.md
senmm May 3, 2020
c85095e
update readme.md
senmm May 3, 2020
08f23b8
update readme.md
senmm May 3, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions exercises/ansible_f5/4.0-explore-tower/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Exercise 4.0: Explore Red Hat Ansible Tower

**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md), ![japan](../../../images/japan.png) [日本語](README.ja.md).

## Table of Contents
- [Exercise 4.0: Explore Red Hat Ansible Tower](#exercise-40-explore-red-hat-ansible-tower)
- [Table of Contents](#table-of-contents)
Expand Down Expand Up @@ -120,6 +122,9 @@ Templates or Job Templates define the parameters that will be used when executin
Additionally, parameters such as logging level and process forks allow for additional granularity on how playbooks are ran.

1. Click on the **Templates** button under **RESOURCES** on the left menu bar.

![templates link](images/templates.png)

2. Under **TEMPLATES** there will be one pre-configured credential, or `Demo Job Template`. Click on the `Demo Job Template`.


Expand Down
2 changes: 2 additions & 0 deletions exercises/ansible_f5/4.1-tower-job-template/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Exercise 4.1: Creating a Tower Job Template

**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md), ![japan](../../../images/japan.png) [日本語](README.ja.md).

## Table of Contents
- [Exercise 4.1: Creating a Tower Job Template](#exercise-41-creating-a-tower-job-template)
- [Table of Contents](#table-of-contents)
Expand Down
80 changes: 47 additions & 33 deletions exercises/ansible_f5/4.2-tower-workflow/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,21 +1,23 @@
# Exercise 4.2: Creating a Workflow

**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md), ![japan](../../../images/japan.png) [日本語](README.ja.md).

## Table of Contents
- [Exercise 4.2: Creating a Workflow](#exercise-42-creating-a-workflow)
- [Table of Contents](#table-of-contents)
- [Objective](#objective)
- [Guide](#guide)
- [Step 0: Prepare Job Templates](#step-0-prepare-job-templates)
- [Step 1: Create a Workflow Template](#step-1-create-a-workflow-template)
- [Step 2: The Workflow Visualizer](#step-2-the-workflow-visualizer)
- [Step 3: Add *Create node* Job Template](#step-3-add-create-node-job-template)
- [Step 4: Add *Create pool* Job Template](#step-4-add-create-pool-job-template)
- [Step 5: Add *Create virtual server* Job Template](#step-5-add-create-virtual-server-job-template)
- [Step 6: *Rollback node deploy* Template](#step-6-rollback-node-deploy-template)
- [Step 7: *Rollback pool deploy* Template](#step-7-rollback-pool-deploy-template)
- [Step 8: *Rollback virtual server* Template](#step-8-rollback-virtual-server-template)
- [Step 9: Run the Workflow](#step-9-run-the-workflow)
- [Step 9: Error Handling](#step-9-error-handling)
- [Step 1: Prepare Job Templates](#step-1-prepare-job-templates)
- [Step 2: Create a Workflow Template](#step-2-create-a-workflow-template)
- [Step 3: The Workflow Visualizer](#step-3-the-workflow-visualizer)
- [Step 4: Add *Create node* Job Template](#step-4-add-create-node-job-template)
- [Step 5: Add *Create pool* Job Template](#step-5-add-create-pool-job-template)
- [Step 6: Add *Create virtual server* Job Template](#step-6-add-create-virtual-server-job-template)
- [Step 7: *Rollback node deploy* Template](#step-7-rollback-node-deploy-template)
- [Step 8: *Rollback pool deploy* Template](#step-8-rollback-pool-deploy-template)
- [Step 9: *Rollback virtual server* Template](#step-9-rollback-virtual-server-template)
- [Step 10: Run the Workflow](#step-10-run-the-workflow)
- [Step 11: Error Handling](#step-11-error-handling)
- [Takeaways](#takeaways)
- [Complete](#complete)

Expand All @@ -27,9 +29,9 @@ For this exercise we will use workflow to achieve the same as the **create_vs**

# Guide

## Step 0: Prepare Job Templates
## Step 1: Prepare Job Templates

Following what we learned from `Lab 4.2`, create the following job templates with the respective playbook:
Following what we learned from `Lab 4.1`, create the following job templates with the respective playbook:

| Job template Name | Playbook |
|---|---|
Expand All @@ -40,7 +42,7 @@ Following what we learned from `Lab 4.2`, create the following job templates wit
| Rollback pool deploy | rollback_pool_deploy.yml |
| Rollback virtual server deploy | rollback_vs_deploy.yml |

Apart from above, we use the same template parameters as `Lab 4.2` for each of the above templates,:
Apart from above, we use the same template parameters as `Lab 4.1` for each of the above templates,:

| Parameter | Value |
|---|---|
Expand All @@ -55,7 +57,7 @@ Here is one example of templates: **Create node**:

![create node](images/create-node.png)

## Step 1: Create a Workflow Template
## Step 2: Create a Workflow Template

1. Click on the **Templates** link on the left menu.

Expand All @@ -73,7 +75,7 @@ Here is one example of templates: **Create node**:

![workflow creation](images/workflow.gif)

## Step 2: The Workflow Visualizer
## Step 3: The Workflow Visualizer

1. When you click the **SAVE** the **WORKFLOW VISUALIZER** should automatically open. If not, click on the blue **WORKFLOW VISUALIZER** button.

Expand All @@ -85,58 +87,65 @@ Here is one example of templates: **Create node**:

The `Create node` job template is now a node. Job or workflow templates are linked together using a graph-like structure called nodes. These nodes can be jobs, project syncs, or inventory syncs. A template can be part of different workflows or used multiple times in the same workflow. A copy of the graph structure is saved to a workflow job when you launch the workflow.

## Step 3: Add *Create node* Job Template
## Step 4: Add *Create node* Job Template

1. Select the **`Create node`** Job Template. Use the only run option of `Always`. Click the green **SELECT** button.
1. Select the **`Create node`** Job Template. Use the only run option of `Always`. Click the green **SELECT** button.

![remove pool](images/create_node.png)

## Step 4: Add *Create pool* Job Template
## Step 5: Add *Create pool* Job Template

1. Hover over the **`Create node`** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
1. Hover over the **`Create node`** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

2. Select the **`Create pool`** job template. For the **Run** parameter select **On Success** from the drop down menu.

3. Click the green **SELECT** button.

![upgrade server](images/create_pool.png)

## Step 5: Add *Create virtual server* Job Template
## Step 6: Add *Create virtual server* Job Template

1. Hover over the **`Create pool`** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
1. Hover over the **`Create pool`** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

2. Select the **`Create virtual server`** job template. For the **Run** parameter select **On Success** from the drop down menu.

3. Click the green **SELECT** button.

![add pool](images/create_virtualserver.png)

## Step 6: *Rollback node deploy* Template
## Step 7: *Rollback node deploy* Template

1. Hover over the **Create node** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
1. Hover over the **Create node** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

2. Select the **Rollback node deploy** job template. For the **Run** parameter select **On Failure** from the drop down menu.

3. Click the green **SELECT** button.

![configure restore node](images/rollback_node.png)

## Step 7: *Rollback pool deploy* Template
## Step 8: *Rollback pool deploy* Template

1. Hover over the **Create pool** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
1. Hover over the **Create pool** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

2. Select the **Rollback pool deploy** job template. For the **Run** parameter select **On Failure** from the drop down menu.

3. Click the green **SELECT** button.

![configure restore node](images/rollback_pool.png)

## Step 8: *Rollback virtual server* Template
## Step 9: *Rollback virtual server* Template

1. Hover over the **Create virtual server** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
1. Hover over the **Create virtual server** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

2. Select the **Rollback virtual server deploy** job template. For the **Run** parameter select **On Failure** from the drop down menu.

3. Click the green **SELECT** button.

![configure restore node](images/rollback_virtualserver.png)

## Step 9: Run the Workflow
4. Click the green **SAVE** button.

## Step 10: Run the Workflow

1. Return to the **Templates** window

Expand All @@ -146,10 +155,10 @@ Here is one example of templates: **Create node**:

At any time during the workflow job you can select an individual job template by clicking on the node to see the status.

## Step 9: Error Handling
## Step 11: Error Handling

Next, we will show a failed job template for the workflow, where a rollback is performed.
1. Click on the `Templates` link on the left menu.
1. Click on the `Templates` link on the left menu.

![templates link](images/templates.png)

Expand All @@ -160,7 +169,8 @@ Next, we will show a failed job template for the workflow, where a rollback is p
The `create_virtualserver_error.yml` playbook will configure the Virtual Server, but tries to attach a pool `http_pool_error` which does not exist. Therefore, the addition of virtual server will fail, and the `Rollback virtual server deploy` node will be triggered.

4. Scroll down and click the green `save` button.
5. Return to the **Templates** window, cick the rocket ship to launch the **Workshop Workflow** workflow template again.

5. Return to the **Templates** window, click the rocket ship to launch the **Workshop Workflow** workflow template again.

![error handling link](images/error_handling.png)

Expand All @@ -169,10 +179,14 @@ The `create_virtualserver_error.yml` playbook will configure the Virtual Server,
Click on **Local Traffic**. then click on **Virtual Servers**, **Pools**, and **Nodes**. You should see that `Rollback virtual server deploy` kicked in and removed all BIG-IP configuration.

Finally, we revert the configuration, and make it ready for next lab:

7. Click on the **Templates** link on the left menu. Select template `Create virtual server`

8. Change the PLAYBOOK back to `create_virtualserver.yml`

9. Scroll down and click the green `save` button.
10. Return to the **Templates** window, cick the rocket ship to launch the **Workshop Workflow** workflow template again.

10. Return to the **Templates** window, click the rocket ship to launch the **Workshop Workflow** workflow template again.


# Takeaways
Expand Down
65 changes: 37 additions & 28 deletions exercises/ansible_f5/4.3-tower-workflow2/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,23 +1,25 @@
# Exercise 4.3: Creating Node Maintenance Workflow

**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md), ![japan](../../../images/japan.png) [日本語](README.ja.md).

## Table of Contents

- [Exercise 4.3: Creating Node Maintenance Workflow](#exercise-43-creating-node-maintenance-workflow)
- [Table of Contents](#table-of-contents)
- [Objective](#objective)
- [Guide](#guide)
- [Step 0: Prepare Job Templates](#step-0-prepare-job-templates)
- [Step 1: Prepare Job Templates](#step-1-prepare-job-templates)
- [Create Server Credential](#create-server-credential)
- [Create Job Templates](#create-job-templates)
- [Step 1: Create a Workflow Template](#step-1-create-a-workflow-template)
- [Step 2: The Workflow Visualizer](#step-2-the-workflow-visualizer)
- [Step 3: Disable node Job Template](#step-3-disable-node-job-template)
- [Step 4: Attach iRule to virtual server Template](#step-4-attach-irule-to-virtual-server-template)
- [Step 4: Patch server Template](#step-4-patch-server-template)
- [Step 5: Enable node Template](#step-5-enable-node-template)
- [Step 6: Detach iRule Template](#step-6-detach-irule-template)
- [Step 6: Create a converged link](#step-6-create-a-converged-link)
- [Step 7: Run the Workflow](#step-7-run-the-workflow)
- [Step 2: Create a Workflow Template](#step-2-create-a-workflow-template)
- [Step 3: The Workflow Visualizer](#step-3-the-workflow-visualizer)
- [Step 4: Disable node Job Template](#step-4-disable-node-job-template)
- [Step 5: Attach iRule to virtual server Template](#step-5-attach-irule-to-virtual-server-template)
- [Step 6: Patch server Template](#step-6-patch-server-template)
- [Step 7: Enable node Template](#step-7-enable-node-template)
- [Step 8: Detach iRule Template](#step-8-detach-irule-template)
- [Step 9: Create a converged link](#step-9-create-a-converged-link)
- [Step 10: Run the Workflow](#step-10-run-the-workflow)
- [Takeaways](#takeaways)
- [Complete](#complete)

Expand All @@ -29,7 +31,7 @@ For this exercise, we will create a workflow for server patch management, first

# Guide

## Step 0: Prepare Job Templates
## Step 1: Prepare Job Templates

### Create Server Credential
Before creating templates, you should create one more credential `Server credential` beforehand, to be utilized by one of the jobs (`Patch server`) to access servers.
Expand All @@ -48,7 +50,7 @@ For this credential, we use the **SSH private key** instead. Get the private key


### Create Job Templates
Similar to the previous lab, we would need to prepare the following templates by following `Lab 4.2`:
Similar to the previous lab, we would need to prepare the following templates by following `Lab 4.1`:

| Job template Name | Playbook |
|---|---|
Expand All @@ -58,7 +60,7 @@ Similar to the previous lab, we would need to prepare the following templates by
| Attach iRule to virtual server | attach_irule.yml |
| Detach iRule | detach_irule.yml |

Again, we use the same template parameters as `Lab 4.2` for each of the above templates, except the parameter of `CREDENTAUL`.
Again, we use the same template parameters as `Lab 4.1` for each of the above templates, except the parameter of `CREDENTAUL`.

For `CREDENTAUL`, the `Patch server` template will use credential `server credential`, and all other templates will be using `Workshop Credential`

Expand All @@ -75,11 +77,11 @@ Here is one example of the templates configured:
![job template](images/job-template.png)


## Step 1: Create a Workflow Template
## Step 2: Create a Workflow Template

1. Click on the **Templates** link on the left menu.

2. Click on the green **+** button. Select the **Workflow Template**.
2. Click on the green ![templates link](images/add.png) button. Select the **Workflow Template**.

3. Fill out the the form as follows:

Expand All @@ -93,64 +95,70 @@ Here is one example of the templates configured:

![workflow creation](images/workflow.png)

## Step 2: The Workflow Visualizer
## Step 3: The Workflow Visualizer

1. When you click the **SAVE**, the **WORKFLOW VISUALIZER** should automatically open. If not click on the blue **WORKFLOW VISUALIZER** button.

2. By default only a green **START** button will appear. Click on the **START** button.

3. The **ADD A TEMPLATE** window will appear on the right.

## Step 3: Disable node Job Template
## Step 4: Disable node Job Template

1. Select the **Disable node** Job Template. Use the drop down box to select run. Click the green **SELECT** button.

![Disable node](images/disable-node.png)

## Step 4: Attach iRule to virtual server Template
## Step 5: Attach iRule to virtual server Template

1. Click on the **START** button, again. The **ADD A TEMPLATE** will appear again.

1. Click on the **START** button, again. The **ADD A TEMPLATE** will appear again.
2. Select the **Attach iRule to virtual server** job template. For the **Run** parameter select **Always** from the drop down menu.

2. Select the **Attach iRule to virtual server** job template. For the **Run** parameter select **On Success** from the drop down menu.
3. Click the green **SELECT** button.

![attach irule](images/attach-irule.png)

## Step 4: Patch server Template
## Step 6: Patch server Template

1. Hover over the **Disable node** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

1. Hover over the **Disable node** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
2. Select the **Patch server** job template. For the **Run** parameter select **On Success** from the drop down menu.

3. Click the green **SELECT** button.

![upgrade server](images/patch-server.png)

## Step 5: Enable node Template
## Step 7: Enable node Template

1. Hover over the **Patch server** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
1. Hover over the **Patch server** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

2. Select the **Enable node** job template. For the **Run** parameter select **On Success** from the drop down menu.

3. Click the green **SELECT** button.

![enable node](images/enable-node.png)

## Step 6: Detach iRule Template
## Step 8: Detach iRule Template

1. Hover over the **Enable node** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.

1. Hover over the **Enable node** node and click the green **+** symbol. The **ADD A TEMPLATE** will appear again.
2. Select the **Detach iRule** job template. For the **Run** parameter select **On Success** from the drop down menu.

3. Click the green **SELECT** button.

![attach irule](images/detach-irule.png)

## Step 6: Create a converged link
## Step 9: Create a converged link

Lastly, we create a covergence link, which allows the jobs running in parallel to converge. In another word, when both jobs finish, `Detach iRule` node will trigger.

1. Hover over the `Attach iRule to virtual server` node and click the blue chain symbol.

2. Now, click on the existing `Detach iRule`. An ADD LINK window will appear. For the RUN parameter choose Always.
![converge link](images/converge-link.png)

## Step 7: Run the Workflow
## Step 10: Run the Workflow

1. Return to the **Templates** window

Expand All @@ -160,6 +168,7 @@ Lastly, we create a covergence link, which allows the jobs running in parallel t

At any time during the workflow job you can select an individual job template by clicking on the node to see the status.

3. Click the green **SAVE** button.

With iRule attached to virtual server, user will receive a maintenance page during the server maintenance:
![maintenance page](images/error-page.png)
Expand Down
Loading