Merge pull request #736 from ansible/devel

March 13th, 2020 release PR

Author: IPvSean

.gitignore

@@ -3,6 +3,7 @@ users.yml
 extra_vars.yml
 *.txt
 !test-requirements.txt
+!bindep.txt
 *.vagrant
 TODO
 TODO.md
@@ -29,3 +30,4 @@ Gemfile.lock
 Gemfile
 _site/*
 .tox/
+provisioner/tests/ci-common.yml

exercises/ansible_network/README.md

@@ -1,6 +1,6 @@
 # Ansible Network Automation Workshop
 
-**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Read this in other languages**: ![uk](../../images/uk.png) [English](README.md),  ![japan](../../images/japan.png) [日本語](README.ja.md).
 
 This content is a multi-purpose toolkit for effectively demonstrating Ansible's capabilities on network equipment (Arista, Cisco, and Juniper) or providing informal workshop training in various forms -- instructor-led, hands-on or self-paced.
 

exercises/ansible_rhel/1.1-setup/README.ja.md

@@ -1,6 +1,11 @@
 # Exercise 1.1 - 要件を確認してみよう
 
-**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [ラボ環境について](#ラボ環境について)
+* [Step 1.1 - 環境へのアクセス](#step-11---環境へのアクセス)
+* [Step 1.2 - Working the Labs](#step-12---working-the-labs)
+* [Step 1.3 - チャレンジLabs](#step-13---チャレンジlabs)
 
 ## ラボ環境について
 
@@ -18,13 +23,13 @@
 SSHでログインできます。:
 
 > **Warning**
-> 
+>
 >  **11.22.33.44** のような文字列を、個々に提供されているStudent情報に記載の **IP** などへ読み替えてください。 **X** は student**X** といった具合です。
 
     ssh [email protected]
 
 > **Tip**
-> 
+>
 > パスワードは **ansible** です。
 
 rootになるには以下のように実行してください。:
@@ -46,7 +51,7 @@ Ansibleが適切にInstallされているかを確認しましょう。
     [...]
 
 > **Note**
-> 
+>
 > Ansibleは構成管理を単純にしてくれます。 Ansibleはデータベースや実行用のデーモンを必要とせず、ラップトップでも簡単に実行できます。 管理対象ホストでは、実行用の常駐エージェントなども不要です。
 
 rootアカウントからログアウトします。
@@ -55,7 +60,7 @@ rootアカウントからログアウトします。
     logout
 
 > **Note**
-> 
+>
 > 以降のすべての演習では、明示的な指示がない限り、コントロールノードのstudent\<X\> ユーザーとして作業してください。
 
 ## Step 1.2 - Working the Labs
@@ -65,12 +70,12 @@ rootアカウントからログアウトします。
   - すべて手で入力するのではなく、必要に応じてブラウザからコピー＆ペーストしてください。しかし、考えたり理解したりするのをやめたりしないでください。
 
   - すべてのラボは **Vim** を使って準備しましたが、みんながそれを愛しているわけではないことを理解しています。 **Midnight Commander** などを利用することができます。(**mc**を 実行すると実行できます。ファンクションキーはEsc-\<n\>でアクセスするかマウスでクリックすることでアクセスできます。）。または **Nano**（**nano**を実行）なども利用できます。 簡単な[editor intro](../0.0-support-docs/editor_intro.md)も用意してあります。
-  
+
 
 
 ## Step 1.3 - チャレンジLabs
 
-このラボガイドの様々な章で「チャレンジラボ」セクションがあります。 
+このラボガイドの様々な章で「チャレンジラボ」セクションがあります。
 これらのラボは、これまでに学んだことを使って解決するための様々なタスクを用意しています。
 それぞれのラボの解答案は、`Warning`サインより下に記述されています。
 

exercises/ansible_rhel/1.1-setup/README.md

@@ -1,6 +1,11 @@
 # Exercise 1.1 - Check the Prerequisites
 
-**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md).
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Your Lab Environment](#your-lab-environment)
+* [Step 1.1 - Access the Environment](#step-11---access-the-environment)
+* [Step 1.2 - Working the Labs](#step-12---working-the-labs)
+* [Step 1.3 - Challenge Labs](#step-13---challenge-labs)
 
 ## Your Lab Environment
 

exercises/ansible_rhel/1.1-setup/README.pt-br.md

@@ -1,6 +1,11 @@
 # Exercício 1.1 - Verifique os pré-requisitos
 
-**Leia em outras linguagens**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md).
+**Leia em outras linguagens**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Seu ambiente de Laboratório](#seu-ambiente-de-laboratório)
+* [Passo 1.1 - Acesse o ambiente](#passo-11---acesse-o-ambiente)
+* [Passo 1.2 - Trabalhando nos laboratórios](#passo-12---trabalhando-nos-laboratórios)
+* [Passo 1.3 - Troca de Labs](#passo-13---troca-de-labs)
 
 ## Seu ambiente de Laboratório
 
@@ -65,7 +70,7 @@ Você já deve ter percebido que este laboratório é centralizado em linha de c
   - Não digite tudo manualmente, use copiar e colar no navegador quando apropriado. Mas pare para pensar e entender.
 
   - Todos os laboratórios foram preparados com o **Vim**, mas entendemos que nem todo mundo gosta dele. Sinta-se livre para usar editores alternativos. No ambiente de laboratório, fornecemos **Midnight Commander** (basta executar **mc**, as teclas de função podem ser acessadas via Esc-\<n\> ou simplesmente clicadas com o mouse) ou **Nano** (excução **nano**). Aqui está uma breve introdução do [editor](../0.0-support-docs/editor_intro.md).
-  
+
 > **Dica**
 >
 > No guia do laboratório, os comandos que você deve executar são mostrados com ou sem a saída esperada, o que fizer mais sentido no contexto.

exercises/ansible_rhel/1.2-adhoc/README.ja.md

@@ -1,6 +1,14 @@
 # Exercise 1.2 - Ad-hoc コマンドを実行しよう
 
-**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Step 1.2.1 - インベントリを操作してみよう](#step-121---インベントリを操作してみよう)
+* [Step 1.2.2 - Ansibleの設定ファイルについて](#step-122---ansibleの設定ファイルについて)
+* [Step 1.2.3 - Ping a host](#step-123---ping-a-host)
+* [Step 1.2.4 - モジュールのリストとヘルプを表示しよう](#step-124---モジュールのリストとヘルプを表示しよう)
+* [Step 1.2.5 - コマンドモジュールを使ってみよう。](#step-125---コマンドモジュールを使ってみよう)
+* [Step 1.2.6 - Copyモジュールとパーミッション](#step-126---copyモジュールとパーミッション)
+* [チャレンジラボ: Modules](#チャレンジラボ-modules)
 
 最初の演習では、Ansible がどのように動作するかを学習するために アドホック・コマンド を実行します。
 Ansible Ad-hocコマンドは、プレイブックを作成しなくてもリモートノードへのタスク実行を可能にします。

exercises/ansible_rhel/1.2-adhoc/README.md

@@ -1,6 +1,14 @@
 # Exercise 1.2 - Running Ad-hoc commands
 
-**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Step 2.1 - Work with your Inventory](#step-21---work-with-your-inventory)
+* [Step 2.2 - The Ansible Configuration Files](#step-22---the-ansible-configuration-files)
+* [Step 2.3 - Ping a host](#step-23---ping-a-host)
+* [Step 2.4 - Listing Modules and Getting Help](#step-24---listing-modules-and-getting-help)
+* [Step 2.5 - Use the command module:](#step-25---use-the-command-module)
+* [Step 2.6 - The copy module and permissions](#step-26---the-copy-module-and-permissions)
+* [Challenge Lab: Modules](#challenge-lab-modules)
 
 For our first exercise, we are going to run some ad-hoc commands to help you get a feel for how Ansible works.  Ansible Ad-Hoc commands enable you to perform tasks on remote nodes without having to write a playbook.  They are very useful when you simply need to do one or two things quickly and often, to many remote nodes.
 

exercises/ansible_rhel/1.2-adhoc/README.pt-br.md

@@ -1,6 +1,14 @@
 # Exercício 1.2 - Executando comandos ad-hoc
 
-**Leia em outras linguagens**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Leia em outras linguagens**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Passo 2.1 - Trabalhe com seu inventário](#passo-21---trabalhe-com-seu-inventário)
+* [Passo 2.2 - Arquivos de configuração Ansible](#passo-22---arquivos-de-configuração-ansible)
+* [Passo 2.3 - Pingando um host](#passo-23---pingando-um-host)
+* [Passo 2.4 - Como listar módulos e obter ajuda](#passo-24---como-listar-módulos-e-obter-ajuda)
+* [Passo 2.5 - Use o módulo de command:](#passo-25---use-o-módulo-de-command)
+* [Passo 2.6 - O módulo de cópia e permissões](#passo-26---o-módulo-de-cópia-e-permissões)
+* [Laboratório de Desafios: Módulos](#laboratório-de-desafios-módulos)
 
 Em nosso primeiro exercício, executaremos alguns comandos ad-hoc para ajudá-lo a entender como o Ansible funciona. Os comandos ad-hoc permitem executar tarefas em nós remotos sem precisar escrever um manual. Eles são muito úteis quando você simplesmente precisa fazer uma ou duas coisas de maneira rápida e frequente para muitos nós remotos.
 
@@ -252,7 +260,7 @@ Execute o comando `ansible node1 -m copy…​` de cima novamente. Nota:
    - A cor de saída diferente (configuração de terminal adequada fornecida).
    - A mudança de `"changed": true,` para `"changed": false,`.
    - A primeira linha diz `SUCCESS` em vez de`CHANGED`.
-   
+
 > **Dica**
 >
 > Isso facilita muito a identificação de alterações e o que o Ansible realmente fez.

exercises/ansible_rhel/1.3-playbook/README.ja.md

@@ -1,6 +1,13 @@
 # Exercise 1.3 - 初めての Playbook 作成
 
-**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Step 1.3.1 - Playbook Basics](#step-131---playbook-basics)
+* [Step 1.3.2 - ディレクトリの構成とPlaybook用のファイルを作成しよう](#step-132---ディレクトリの構成とplaybook用のファイルを作成しよう)
+* [Step 1.3.3 - Playbookを実行してみる](#step-133---playbookを実行してみる)
+* [Step 1.3.4 - Playbookを拡張してみよう。Apacheの起動と有効化](#step-134---playbookを拡張してみようapacheの起動と有効化)
+* [Step 1.3.5 - Playbookを拡張してみよう。index.htmlの作成](#step-135---playbookを拡張してみようindexhtmlの作成)
+* [Step 1.3.6 - 練習: 複数ホストへの適用](#step-136---練習-複数ホストへの適用)
 
 Ansibleのアドホックコマンドは単純なオペレーションの際にはとても役立ちますが、複雑な構成管理やオーケストレーションのシナリオには適していません。そのようなユースケースの時には、*playbooks*を用いてみると良いでしょう。
 

exercises/ansible_rhel/1.3-playbook/README.md

@@ -1,6 +1,13 @@
 # Exercise 1.3 - Writing Your First Playbook
 
-**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Read this in other languages**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Step 3.1 - Playbook Basics](#step-31---playbook-basics)
+* [Step 3.2 - Creating a Directory Structure and File for your Playbook](#step-32---creating-a-directory-structure-and-file-for-your-playbook)
+* [Step 3.3 - Running the Playbook](#step-33---running-the-playbook)
+* [Step 3.4 - Extend your Playbook: Start & Enable Apache](#step-34---extend-your-playbook-start--enable-apache)
+* [Step 3.5 - Extend your Playbook: Create an index.html](#step-35---extend-your-playbook-create-an-indexhtml)
+* [Step 3.6 - Practice: Apply to Multiple Host](#step-36---practice-apply-to-multiple-host)
 
 While Ansible ad hoc commands are useful for simple operations, they are not suited for complex configuration management or orchestration scenarios. For such use cases *playbooks* are the way to go.
 
@@ -108,8 +115,8 @@ In the added lines:
 
   - A task is named and the module for the task is referenced. Here it uses the `yum` module.
 
-  - Parameters for the module are added: 
-  
+  - Parameters for the module are added:
+
     - `name:` to identify the package name
     - `state:` to define the wanted state of the package
 

exercises/ansible_rhel/1.3-playbook/README.pt-br.md

@@ -1,6 +1,13 @@
 # Exercício 1.3 - Escrevendo seu primeiro Playbook
 
-**Leia em outras linguagens**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png) [日本語](README.ja.md).
+**Leia em outras linguagens**: ![uk](../../../images/uk.png) [English](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Portugues do Brasil](README.pt-br.md).
+
+* [Passo 3.1 - Noções básicas do Playbook](#passo-31---noções-básicas-do-playbook)
+* [Passo 3.2 - Criando uma estrutura de diretórios e um arquivo para o seu Playbook](#passo-32---criando-uma-estrutura-de-diretórios-e-um-arquivo-para-o-seu-playbook)
+* [Passo 3.3 - Rodando o Playbook](#passo-33---rodando-o-playbook)
+* [Passo 3.4 - Amplie seu playbook: Apache Start & Enable](#passo-34---amplie-seu-playbook-apache-start--enable)
+* [Passo 3.5 - Ampliando seu Playbook: Criando um aquivo index.html](#passo-35---ampliando-seu-playbook-criando-um-aquivo-indexhtml)
+* [Passo 3.6 - Pratique: Aplicar a vários hosts](#passo-36---pratique-aplicar-a-vários-hosts)
 
 Embora os comandos Ansible ad hoc sejam úteis para operações simples, eles não são adequados para cenários complexos de gerenciamento ou orquestração de configurações. Para tais casos de uso, os playbooks são o caminho a percorrer.
 
@@ -48,7 +55,7 @@ Chega de teoria, é hora de criar seu primeiro Playbook. Neste laboratório, voc
 
   - 2ª Etapa: Enable/start o serviço httpd
 
-  - 3ª Etapa: Criar um aquivo index.html 
+  - 3ª Etapa: Criar um aquivo index.html
 
 Este Playbook garante que o pacote que contém o servidor Apache esteja instalado no `node1`.
 
@@ -108,10 +115,10 @@ Nas linhas adicionadas:
   - Uma task é nomeada e o módulo da task é referenciado. Aqui ele usa o módulo `yum`.
 
   - Parâmetros para o módulo são adicionados:
-  
+
     - `name:` identifica o nome do pacote.
     - `state:` para definir o estado desejado do pacote.
-    
+
 > **Dica**
 >
 > Os parâmetros do módulo são individuais para cada módulo. Em caso de dúvida, procure-os novamente com `ansible-doc`.
@@ -156,7 +163,7 @@ Efetue logout do `node1` com o comando `exit` para voltar ao host de controle e
 
 Execute o Playbook pela segunda vez e compare a saída: A saída mudou de "changed" para "ok" e a cor mudou de amarelo para verde. Além disso, o "PLAY RECAP" é diferente agora. Isso facilita a identificação do que o Ansible realmente fez.
 
-## Passo 3.4 - Amplie seu playbook: Apache Start & Enable 
+## Passo 3.4 - Amplie seu playbook: Apache Start & Enable
 
 A próxima parte do Playbook garante que o servidor Apache esteja startado e habilitado no `node1`.
 
@@ -198,7 +205,7 @@ Observe a saída agora: algumas tasks são mostradas como "ok" em verde e uma é
   - Use um comando Ansible ad hoc novamente para garantir que o Apache tenha sido ativado e iniciado, por exemplo com: `systemctl status httpd`.
 
   - Execute o Playbook uma segunda vez para se acostumar com a alteração na saída.
-  
+
 ## Passo 3.5 - Ampliando seu Playbook: Criando um aquivo index.html
 
 Verifique se as tasks foram executadas corretamente e o Apache está aceitando conexões: faça uma solicitação HTTP usando o módulo `uri` em um comando ad hoc a partir do nó de controle. Certifique-se de substituir **\<IP\>** pelo IP do nó do inventário.