Merging content from devel to main

.github/workflows/main.yml

@@ -40,3 +40,5 @@ jobs:
           job_template: "Workshop teardown Job"
           extra_vars: "ec2_name_prefix=github-action-test-sep19"
           validate_certs: false
+        env:
+          pull_request_event: ${{ github.event.pull_request.number }}

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

@@ -1,98 +1,149 @@
-# Workshop Ejercicio - Validación de los pre-requisitos
+# Ejercicio del Taller - Verificar los Prerrequisitos
 
-**Leer esto en otros idiomas**:
-<br>![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), ![france](../../../images/fr.png) [Française](README.fr.md),![Español](../../../images/col.png) [Español](README.es.md).
+**Lee esto en otros idiomas**:
+<br>![uk](../../../images/uk.png) [Inglés](README.md),  ![japan](../../../images/japan.png)[日本語](README.ja.md), ![brazil](../../../images/brazil.png) [Português do Brasil](README.pt-br.md), ![france](../../../images/fr.png) [Francés](README.fr.md),![Español](../../../images/col.png) [Español](README.es.md).
 
-## Tabla de contenidos
+## Tabla de Contenidos
 
-* [Objetivos](#Objetivos)
-* [Guía](#Guía)
-* [Su entorno de laboratorio](#Su-entorno-de-laboratorio)
-* [Paso 1 - Acceso al entorno](#Paso-1---Acceso-al-entorno)
-* [Paso 2 - Trabajar los laboratorios](#Paso-2---Trabajar-los-laboratorios)
-* [Paso 3 - Laboratorios de desafío](#Paso-3---Laboratorios-de-desafío)
+- [Ejercicio del Taller - Verificar los Prerrequisitos](#ejercicio-del-taller---verificar-los-prerrequisitos)
+  - [Tabla de Contenidos](#tabla-de-contenidos)
+  - [Objetivo](#objetivo)
+  - [Guía](#guía)
+    - [Tu Entorno de Laboratorio](#tu-entorno-de-laboratorio)
+    - [Paso 1 - Acceder al Entorno](#paso-1---acceder-al-entorno)
+    - [Paso 2 - Usando la Terminal](#paso-2---usando-la-terminal)
+    - [Paso 3 - Examinar los Entornos de Ejecución](#paso-3---examinar-los-entornos-de-ejecución)
+    - [Paso 4 - Examinar la configuración de ansible-navigator](#paso-4---examinar-la-configuración-de-ansible-navigator)
+    - [Paso 5 - Labs de Desafío](#paso-5---labs-de-desafío)
 
-# Objetivos
+## Objetivos
 
-- Comprender la topología de laboratorio y cómo acceder al entorno.
-- Comprender cómo trabajar los ejercicios del taller
-- Comprender los laboratorios de desafío
+* Entender la Topología del Laboratorio: Familiarízate con el entorno de laboratorio y los métodos de acceso.
+* Dominar los Ejercicios del Taller: Adquiere competencia en la navegación y ejecución de las tareas del taller.
+* Resolver los desafíos del taller: Aprende a aplicar tus conocimientos en escenarios prácticos
 
-# Guía
+## Guía
 
-## Su entorno de laboratorio
+La fase inicial de este taller se centra en las utilidades de línea de comandos de Ansible Automation Platform, como:
 
-En este laboratorio se trabaja en un entorno de laboratorio preconfigurado. Tendrá acceso a los siguientes hosts:
 
-| Role                 | Inventory name |
-| ---------------------| ---------------|
-| Ansible Control Host | ansible        |
-| Managed Host 1       | node1          |
-| Managed Host 2       | node2          |
-| Managed Host 3       | node3          |
+- [ansible-navigator](https://github.com/ansible/ansible-navigator) - una Interfaz de Usuario basada en Texto (TUI) para ejecutar y desarrollar contenido de Ansible.
+- [ansible-core](https://docs.ansible.com/core.html) - el ejecutable base que proporciona el marco, lenguaje y funciones que sustentan Ansible Automation Platform, incluyendo herramientas de línea de comandos como `ansible`, `ansible-playbook` y `ansible-doc`.
+- [Entornos de Ejecución](https://docs.ansible.com/automation-controller/latest/html/userguide/execution_environments.html) - Imágenes de contenedor pre-construidas con colecciones soportadas por Red Hat.
+- [ansible-builder](https://github.com/ansible/ansible-builder) - automatiza el proceso de construcción de Entornos de Ejecución. No es un enfoque principal en este taller.
 
-## Paso 1 - Acceso al entorno
+Si necesitas más información sobre los nuevos componentes de la Plataforma de Automatización Ansible, guarda esta página principal [https://red.ht/AAP-20](https://red.ht/AAP-20)
 
-Inicie sesión en el host de control a través de SSH:
 
-> **Advertencia**
->
-> Reemplace **11.22.33.44** por la **IP** que se le proporciona, y la **X** por student**X** con el número de estudiante que se le proporcionó.
+### Tu Entorno de Laboratorio
 
-    ssh studentX@11.22.33.44
+Trabajarás en un entorno pre-configurado con los siguientes hosts:
 
-> **Consejo**
->
-> La contraseña sera proporcionada por el instructor
 
-Para pasarse a usuario root:
+| Rol                   | Nombre en el inventario |
+| ---------------------| -----------------------|
+| Host de Control Ansible | ansible-1      |
+| Host Gestionado 1       | node1          |
+| Host Gestionado 2       | node2          |
+| Host Gestionado 3       | node3          |
 
-    [student<X>@ansible ~]$ sudo -i
+### Paso 1 - Acceder al Entorno
 
-La mayoría de las tareas de requisitos previos ya se han realizado por usted:
+Recomendamos usar Visual Studio Code para este taller por su navegador de archivos integrado, editor con resaltado de sintaxis y terminal en el navegador. El acceso directo SSH también está disponible. Consulta este tutorial de YouTube sobre cómo acceder a tu entorno de trabajo.
 
-  - Se instala el software Ansible
+NOTA: Se proporciona un breve video de YouTube si necesitas claridad adicional:
+[Ansible Workshops - Acceder a tu entorno de trabajo](https://youtu.be/Y_Gx4ZBfcuk)
 
-  - Conexión SSH y las claves están configuradas
 
-  - `sudo` se ha configurado en los hosts administrados para ejecutar comandos que requieren privilegios de root.
+1. Conéctate a Visual Studio Code a través de la página de lanzamiento del taller.
 
+  ![página de lanzamiento](images/launch_page.png)
 
-Compruebe que Ansible se ha instalado correctamente
+2. Ingresa la contraseña proporcionada para iniciar sesión.
 
-    [root@ansible ~]# ansible --version
-    ansible 2.7.0
-    [...]
+  ![inicio de sesión en vs code](images/vscode_login.png)
 
-> **Nota**
->
-> Ansible mantiene la administración de la configuración simple. Ansible no requiere base de datos ni demonios en ejecución y puede ejecutarse fácilmente en un portátil. En los hosts administrados no necesita ningún agente en ejecución.
 
-Cierre la sesión de la cuenta root de nuevo:
+### Paso 2 - Usando la Terminal
 
-    [root@ansible ~]# exit
-    logout
+1. Abre una terminal en Visual Studio Code:
 
-> **Nota**
->
->En todos los ejercicios posteriores, debe trabajar como el usuario student\<X\> en el nodo de control si no se le indica explícitamente de forma diferente.
+  ![imagen de nueva terminal](images/vscode-new-terminal.png)
 
-## Paso 2 - Trabajar los laboratorios
+2. Navega al directorio `rhel-workshop` en la terminal del nodo de control de Ansible.
 
-Es posible que ya haya adivinado que este laboratorio está bastante centrado en la línea de comandos... :-)
+```bash
+[student@ansible-1 ~]$ cd ~/rhel-workshop/
+[student@ansible-1 rhel-workshop]$ pwd
+/home/student/rhel-workshop
+```
 
-  - No escriba todo manualmente, utilice copiar y pegar desde el navegador cuando sea apropiado. Pero detente a pensar y entender.
+* `~`: atajo para el directorio home `/home/student`
+* `cd`: comando para cambiar de directorio
+* `pwd`: imprime la ruta completa del directorio de trabajo actual.
 
-  - Todos los laboratorios fueron preparados usando **Vim**, pero entendemos que no a todo el mundo le encanta. Siéntase libre de usar editores alternativos. En el entorno de laboratorio que proporcionamos **Midnight Commander** (simplemente ejecute **mc**, se puede acceder a las teclas de función a través de Esc-\<n\>, y simplemente haga clic con el ratón) o **Nano** (ejecutar **nano**). Aquí hay un breve [introducción del editor](.. /0.0-support-docs/editor_intro.md).
+### Paso 3 - Examinar los Entornos de Ejecución
 
+1. Ejecuta `ansible-navigator images` para ver los Entornos de Ejecución configurados.
+2. Usa el número correspondiente para investigar un EE, por ejemplo, presionando 2 para abrir `ee-supported-rhel8`
 
-> **Consejo**
->
-> En los comandos de la guía de laboratorio que se supone que debe ejecutar se muestran con o sin la salida esperada, lo que tenga más sentido en el contexto.
+```bash
+$ ansible-navigator images
+```
 
-## Paso 3 - Laboratorios de desafío
+![ansible-navigator images](images/navigator-images.png)
+
+
+> Nota: La salida que veas puede diferir de la salida anterior
+
+
+![menú principal ee](images/navigator-ee-menu.png)
+
+Seleccionar `2` para `Versión de Ansible y colecciones` nos mostrará todas las Colecciones de Ansible instaladas en ese EE particular, y la versión de `ansible-core`:
+
+![información ee](images/navigator-ee-collections.png)
+
+### Paso 4 - Examinar la configuración de ansible-navigator
+
+1. Visualiza el contenido de `~/.ansible-navigator.yml` usando Visual Studio Code o el comando `cat`.
+
+```bash
+$ cat ~/.ansible-navigator.yml
+---
+ansible-navigator:
+  ansible:
+    inventory:
+      entries:
+      - /home/student/lab_inventory/hosts
+
+  execution-environment:
+    image: registry.redhat.io/ansible-automation-platform-20-early-access/ee-supported-rhel8:2.0.0
+    enabled: true
+    container-engine: podman
+    pull:
+      policy: missing
+    volume-mounts:
+    - src: "/etc/ansible/"
+      dest: "/etc/ansible/"
+```
+
+2. Observa los siguientes parámetros dentro del archivo `ansible-navigator.yml`:
+
+* `inventories`: muestra la ubicación del inventario de ansible que se está utilizando
+* `execution-environment`: donde se establece el entorno de ejecución predeterminado
+
+Para una lista completa de cada configuración configurable consulta la [documentación](https://ansible.readthedocs.io/projects/navigator/settings/)
+
+<<<<<<< HEAD
+### Paso 5 - Desafíos del taller
+
+Cada capítulo del taller viene con un desafío. Estas tareas prueban tu comprensión y aplicación de los conceptos aprendidos. Las soluciones se proporcionan bajo un signo de advertencia para referencia.
+=======
+### Paso 5 - Labs de Desafío
+
+Cada capítulo viene con un Lab de Desafío. Estas tareas prueban tu comprensión y aplicación de los conceptos aprendidos. Las soluciones se proporcionan bajo un signo de advertencia para referencia.
+>>>>>>> daf03aad826095b4ee06f20aa28c409189bb47b9
 
-Pronto descubrirá que muchos capítulos de esta guía de laboratorio vienen con una sección de "Laboratorio de desafío". Estos laboratorios están destinados a darle una pequeña tarea para resolver utilizando lo que ha aprendido hasta ahora. La solución de la tarea se muestra debajo de un signo de advertencia.
 
 ----
 **Navegación**