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

translations to ex14 #2099

Merged
merged 1 commit into from
Feb 9, 2024
Merged

translations to ex14 #2099

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
300 changes: 102 additions & 198 deletions exercises/ansible_rhel/1.4-variables/README.es.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,253 +1,157 @@
# Workshop - Uso de variables
# Ejercicio de Taller - Uso de Variables

**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).
**Lea 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 de 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
## Índice de Contenidos

* [Objetivos](#Objetivos)
* [Guía](#Guía)
* [Introducción a variables](#Introducción-a-variables)
* [Paso 1 - Crear archivos de variables](#Paso-1---Crear-archivos-de-variables)
* [Paso 2 - Crear archivos index.html](#paso-2---Crear-archivos-indexhtml)
* [Paso 3 - Crear el Playbook](#Paso-3---Crear-el-Playbook)
* [Paso 4 - Prueba el resultado](#Paso-4---Prueba-el-resultado)
* [Paso 5 - Ansible Facts](#Paso-5---Ansible-Facts)
* [Paso 6 - Laboratorios de desafío: Facts](#Paso-6---Laboratorios-de-desafío-Facts)
* [Paso 7 - Uso de Facts en playbooks](#Paso-7---Uso-de-Facts-en-playbooks)
- [Ejercicio de Taller - Uso de Variables](##ejercicio-de-taller---uso-de-variables)
- [Objetivo](#objetivo)
- [Guía](#guía)
- [Paso 1 - Entendiendo las Variables](#paso-1---entendiendo-las-variables)
- [Paso 2 - Sintaxis y Creación de Variables](#paso-2---sintaxis-y-creación-de-variables)
- [Paso 3 - Ejecutando el Playbook Modificado](#paso-3---ejecutando-el-playbook-modificado)
- [Paso 4 - Uso Avanzado de Variables en el Playbook de Verificaciones](#paso-4---uso-avanzado-de-variables-en-el-playbook-de-verificaciones)

# Objetivos
Ansible admite variables para almacenar valores que se pueden utilizar en Playbooks. Las variables se pueden definir en una variedad de lugares y tienen una prioridad clara. Ansible sustituye la variable por su valor cuando se ejecuta una tarea.
## Objetivo
Extendiendo nuestros playbooks del Ejercicio 1.3, el enfoque se centra en la creación y uso de variables en Ansible. Aprenderás la sintaxis para definir y usar variables, una habilidad esencial para crear playbooks dinámicos y adaptables.

Este ejercicio abarca variables, específicamente
- Cómo utilizar los delimitadores de variables `{{` and `}}`
- Qué son los `host_vars` y los `group_vars` y cuándo utilizarlos
- Cómo utilizar `ansible_facts`
- Cómo utilizar el módulo `debug` para imprimir variables en la ventana de la consola
## Guía
Las variables en Ansible son herramientas poderosas para hacer tus playbooks flexibles y reutilizables. Te permiten almacenar y reutilizar valores, haciendo tus playbooks más dinámicos y adaptables.

# Guía
### Paso 1 - Entendiendo las Variables
Una variable en Ansible es una representación nombrada de algún dato. Las variables pueden contener valores simples como cadenas y números, o datos más complejos como listas y diccionarios.

## Introducción a variables
### Paso 2 - Sintaxis y Creación de Variables
La creación y uso de variables involucra una sintaxis específica:

Se hace referencia a las variables en Playbooks colocando el nombre de la variable entre llaves dobles:
1. Definición de Variables: Las variables se definen en la sección `vars` de un playbook o en archivos separados para proyectos más grandes.
2. Nombramiento de Variables: Los nombres de las variables deben ser descriptivos y seguir reglas tales como:
* Comenzar con una letra o un guión bajo.
* Contener solo letras, números y guiones bajos.
3. Uso de Variables: Las variables se referencian en las tareas utilizando las llaves dobles en comillas `"{{ nombre_variable }}"`. Esta sintaxis indica a Ansible que la reemplace con el valor de la variable en tiempo de ejecución.

<!-- {% raw %} -->
```yaml
Here comes a variable {{ variable1 }}
```
<!-- {% endraw %} -->

Las variables y sus valores se pueden definir en varios lugares: el inventario, archivos adicionales, en la línea de comandos, etc.

La práctica recomendada para proporcionar variables en el inventario es definirlas en archivos ubicados en dos directorios denominados `host_vars` y `group_vars`:

- Para definir variables para un grupo llamado "servers", se crea un archivo YAML denominado `group_vars/servers.yml` con las definiciones de variables.

- Para definir variables específicamente para un host `node1`, se crea el archivo `host_vars/node1.yml` con las definiciones de variables.

> **Consejo**
>
> Las variables de host tienen prioridad sobre las variables de grupo (puede encontrar más infromación sobre la prioridad en este [documento](https://docs.ansible.com/ansible/latest/user_guide/playbooks_variables.html#variable-precedence-where-should-i-put-a-variable)).


## Paso 1 - Crear archivos de variables

Para la comprensión y la práctica vamos a hacer un laboratorio. Siguiendo el tema "Vamos a crear un servidor web. O dos. O incluso más... ", cambiará el `index.html` para mostrar el entorno de desarrollo (dev/prod) en el que se implementa un servidor.

En el host de control ansible, como usuario `student<X>`, cree los directorios que contendran las definiciones de variables en `~/ansible-files/`:

```bash
[student<X>@ansible ansible-files]$ mkdir host_vars group_vars
```

Ahora cree dos archivos que contengan definiciones de variables. Definiremos una variable denominada `stage` que apuntará a diferentes entornos, `dev` o `prod`:

- Cree el archivo `~/ansible-files/group_vars/web.yml` con este contenido:

```yaml
---
stage: dev
```
- Cree el archivo `~/ansible-files/host_vars/node2.yml` con este contenido:
Actualiza el playbook `system_setup.yml` para incluir y usar una variable:

```yaml
---
stage: prod
- name: Basic System Setup
hosts: node1
become: true
vars:
user_name: 'Roger'
tasks:
- name: Update all security-related packages
ansible.builtin.dnf:
name: '*'
state: latest
security: true

- name: Create a new user
ansible.builtin.user:
name: "{{ user_name }}"
state: present
create_home: true
```
¿De qué se trata esto?

- Para todos los servidores del grupo `web` se define la variable `stage` con el valor `dev`. Por lo tanto, de forma predeterminada los marcamos como miembros del entorno de desarrollo.

- Para el servidor `node2` esto se anula y el host se marca como un servidor de producción.

## Paso 2 - Crear archivos index.html
Ejecuta este playbook con `ansible-navigator`.

Ahora, cree dos archivos en `~/ansible-files/files/`:
### Paso 3 - Ejecutando el Playbook Modificado

Uno llamado `prod_web.html` con el siguiente contenido:
Ejecuta el playbook actualizado:

```html
<body>
<h1>This is a production webserver, take care!</h1>
</body>
```bash
[student@ansible-1 lab_inventory]$ ansible-navigator run system_setup.yml -m stdout
```

Y el otro llamado `dev_web.html` con el siguiente contenido:

```html
<body>
<h1>This is a development webserver, have fun!</h1>
</body>
```
PLAY [Basic System Setup] ******************************************************

## Paso 3 - Crear el Playbook

Ahora necesitas un Playbook que copie el archivo prod o dev `web.html` - de acuerdo con la variable "stage".

Cree un nuevo Playbook llamado `deploy_index_html.yml` en el directorio '`~/ansible-files/`.

> **Consejo**
>
> Tenga en cuenta cómo se utiliza la variable "stage" en el nombre del archivo que se va a copiar.
TASK [Gathering Facts] *********************************************************
ok: [node1]

<!-- {% raw %} -->
```yaml
---
- name: Copy web.html
hosts: web
become: yes
tasks:
- name: copy web.html
copy:
src: "{{ stage }}_web.html"
dest: /var/www/html/index.html
```
<!-- {% endraw %} -->
TASK [Update all security-related packages] ************************************
ok: [node1]

- Ejecute el Playbook:
TASK [Create a new user] *******************************************************
changed: [node1]

```bash
[student<X>@ansible ansible-files]$ ansible-playbook deploy_index_html.yml
PLAY RECAP *********************************************************************
node1 : ok=3 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
```

## Paso 4 - Prueba el resultado
Observa cómo el playbook actualizado muestra un estado de "cambiado" en la tarea de Crear un nuevo usuario. El usuario, ‘Roger’, especificado en la sección vars ha sido creado.

El Playbook debe copiar diferentes archivos como index.html a los hosts, utilice `curl` para probarlo. Compruebe el archivo de inventario de nuevo si olvidó las direcciones IP de los nodos.
Verifica la creación del usuario mediante:

```bash
[student<X>@ansible ansible-files]$ grep node ~/lab_inventory/hosts
node1 ansible_host=11.22.33.44
node2 ansible_host=22.33.44.55
node3 ansible_host=33.44.55.66
[student<X>@ansible ansible-files]$ curl http://11.22.33.44
<body>
<h1>This is a development webserver, have fun!</h1>
</body>
[student1@ansible ansible-files]$ curl http://22.33.44.55
<body>
<h1>This is a production webserver, take care!</h1>
</body>
[student1@ansible ansible-files]$ curl http://33.44.55.66
<body>
<h1>This is a development webserver, have fun!</h1>
</body>
[student@ansible-1 lab_inventory]$ ssh node1 id Roger
```

> **Consejo**
>
> Si a estas alturas piensas: tiene que haber una manera más inteligente de cambiar el contenido en los archivos... tienes toda la razón. Este laboratorio se hizo para introducir variables, está a punto de aprender acerca de las plantillas en uno de los siguientes capítulos.

## Paso 5 - Ansible Facts
### Paso 4 - Uso Avanzado de Variables en el Playbook de Verificaciones
Mejora el playbook `system_checks.yml` para verificar la existencia del usuario ‘Roger’ en el sistema utilizando la variable `register` y la declaración condicional `when`.

Los facts de ansible son variables que Ansible detecta automáticamente desde un host administrado. ¿Recuerdas la tarea "Gathering Facts" que aparece en la salida de cada ejecución de `ansible-playbook`? En ese momento se recopilan los facts para cada nodo administrado. Los facts también se pueden extraer mediante el módulo `setup`. Contienen información útil almacenada en variables que los administradores pueden reutilizar.
La palabra clave `register` en Ansible se utiliza para capturar la salida de una tarea y guardarla como una variable.

Para hacerse una idea de los facts que Ansible recopila de forma predeterminada, en el nodo de control como usuario student ejecúte:

```bash
[student<X>@ansible ansible-files]$ ansible node1 -m setup
```

Esto puede ser un poco demasiado, puede utilizar filtros para limitar la salida a ciertos facts, las expresiones son comodines de estilo shell:

```bash
[student<X>@ansible ansible-files]$ ansible node1 -m setup -a 'filter=ansible_eth0'
```
O qué pasa con sólo buscar facts relacionados con la memoria:
Actualiza el playbook `system_checks.yml`:

```bash
[student<X>@ansible ansible-files]$ ansible node1 -m setup -a 'filter=ansible_*_mb'
```yaml
---
- name: System Configuration Checks
hosts: node1
become: true
vars:
user_name: 'Roger'
tasks:
- name: Check user existence
ansible.builtin.command:
cmd: "id {{ user_name }}"
register: user_check

- name: Report user status
ansible.builtin.debug:
msg: "El usuario {{ user_name }} existe."
when: user_check.rc == 0
```

## Paso 6 - Laboratorios de desafío: Facts
Detalles del Playbook:

- Intente buscar e imprimir la distribución (Red Hat) de los hosts administrados. En una línea, por favor.
* `register: user_check:` Esto captura la salida del comando id en la variable user_check.
* `when: user_check.rc == 0:` Esta línea es una declaración condicional. Verifica si el código de retorno (rc) de la tarea anterior (almacenado en user_check) es 0, lo que indica éxito. El mensaje de depuración solo se mostrará si se cumple esta condición.

> **Consejo**
>
> Utilice grep para encontrar el facts y, a continuación, aplique un filtro para imprimir solo este fact.
Esta configuración proporciona un ejemplo práctico de cómo se pueden usar las variables para controlar el flujo de tareas basado en los resultados de pasos anteriores.

> **Advertencia**
>
> **Solución a continuación\!**
Ejecuta el playbook de verificaciones:

```bash
[student<X>@ansible ansible-files]$ ansible node1 -m setup|grep distribution
[student<X>@ansible ansible-files]$ ansible node1 -m setup -a 'filter=ansible_distribution' -o
[student@ansible-1 lab_inventory]$ ansible-navigator run system_checks.yml -m stdout
```

## Paso 7 - Uso de Facts en playbooks
Salida:

Los facts se pueden utilizar en un playbook como variables, utilizando el nombre adecuado, por supuesto. Cree este Playbook como `facts.yml` en el directorio `~/ansible-files/`:

<!-- {% raw %} -->
```yaml
---
- name: Output facts within a playbook
hosts: all
tasks:
- name: Prints Ansible facts
debug:
msg: The default IPv4 address of {{ ansible_fqdn }} is {{ ansible_default_ipv4.address }}
```
<!-- {% endraw %} -->

> **Consejo**
>
> El módulo "debug" es útil para, por ejemplo, depurar variables o expresiones.

Ejecútelo para ver cómo se imprimen los facts:

```bash
[student<X>@ansible ansible-files]$ ansible-playbook facts.yml

PLAY [Output facts within a playbook] ******************************************
PLAY [System Configuration Checks] *********************************************

TASK [Gathering Facts] *********************************************************
ok: [node3]
ok: [node2]
ok: [node1]
ok: [ansible]

TASK [Prints Ansible facts] ****************************************************
ok: [node1] =>
msg: The default IPv4 address of node1 is 172.16.190.143
ok: [node2] =>
msg: The default IPv4 address of node2 is 172.16.30.170
ok: [node3] =>
msg: The default IPv4 address of node3 is 172.16.140.196
ok: [ansible] =>
msg: The default IPv4 address of ansible is 172.16.2.10

TASK [Check user existence] ****************************************************
changed: [node1]

TASK [Report user status] ******************************************************
ok: [node1] => {
"msg": "El usuario Roger existe."
}

PLAY RECAP *********************************************************************
ansible : ok=2 changed=0 unreachable=0 failed=0
node1 : ok=2 changed=0 unreachable=0 failed=0
node2 : ok=2 changed=0 unreachable=0 failed=0
node3 : ok=2 changed=0 unreachable=0 failed=0
node1 : ok=3 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
```

----
Revisa la salida para confirmar que la verificación de la existencia del usuario está utilizando correctamente la variable y la lógica condicional.
---
**Navegación**
<br>
[Ejercicio anterior](../1.3-playbook/README.es.md) - [Próximo Ejercicio](../1.5-handlers/README.es.md)

[Haga clic aquí para volver al Taller Ansible for Red Hat Enterprise Linux](../README.md#section-1---ansible-engine-exercises)
[Ejercicio Anterior](../1.3-playbook/README.es.md) - [Siguiente Ejercicio](../1.5-handlers/README.es.md)
<br><br>
[Haz clic aquí para volver al Taller de Ansible para Red Hat Enterprise Linux](../README.md)"
Loading