Note:

Este tutorial está disponible en un entorno de prácticas gratuito proporcionado por Oracle.
Utiliza valores de ejemplo para credenciales, arrendamiento y compartimentos de Oracle Cloud Infrastructure. Al finalizar la práctica, sustituya estos valores por otros específicos de su entorno en la nube.

Uso de la recopilación de OCI Ansible con Oracle Linux Automation Manager

Introducción

La recopilación de Ansible de Oracle Cloud Infrastructure (OCI) proporciona una forma sencilla de aprovisionar y gestionar recursos en Oracle Cloud mediante Oracle Linux Automation Engine u Oracle Linux Automation Manager.

Objetivos

En este tutorial, aprenderá a:

Crear un cuaderno de estrategias que utilice la recopilación de Ansible de OCI
Configurar credenciales para Ansible Galaxy
Agregar la credencial de Oracle Cloud Infrastructure
Creación de una plantilla de trabajo
Ejecute el trabajo

Requisitos

Un sistema con Oracle Linux Automation Manager instalado
Acceso a un repositorio de git
Una cuenta de Oracle Cloud Infrastructure (OCI)
Un usuario de la cuenta de OCI con permiso para trabajar con recursos en un compartimento
Acceso a las credenciales y la información de OCID de esa cuenta

Despliegue de Oracle Linux Automation Manager

Nota: Si se ejecuta en su propio arrendamiento, lea el proyecto linux-virt-labs GitHub README.md y complete los requisitos antes de desplegar el entorno de prácticas.

Abra un terminal en el escritorio Luna.

Clone el proyecto linux-virt-labs GitHub.

git clone https://github.com/oracle-devrel/linux-virt-labs.git

Cambie al directorio de trabajo.
```
cd linux-virt-labs/olam
```

Instale las recopilaciones necesarias.

ansible-galaxy collection install -r requirements.yml

Actualice la configuración de la instancia de Oracle Linux.

cat << EOF | tee instances.yml > /dev/null
compute_instances:
  1:
    instance_name: "olam-node"
    type: "control"
  2:
    instance_name: "git-server"
    type: "server"
use_git: true
olam_type: single
EOF

Cree un archivo de inventario.

cat << EOF | tee hosts > /dev/null
localhost ansible_connection=local ansible_connection=local ansible_python_interpreter=/usr/bin/python3.6
EOF

Despliegue el entorno de prácticas.
```
ansible-playbook create_instance.yml -i hosts -e "@instances.yml"
```
El entorno de prácticas gratuitas necesita la variable adicional ansible_python_interpreter para localhost porque instala el paquete RPM para el SDK para Python de Oracle Cloud Infrastructure. La ubicación para instalar este paquete se encuentra en los módulos de Python por defecto del sistema según la versión de Oracle Linux. El uso de una variable de inventario evita que las reproducciones se ejecuten en hosts que no sean localeshost.

La unidad de despliegue por defecto utiliza la CPU de AMD. Puede cambiar la unidad de las instancias transfiriendo una nueva definición de variable de unidad en la línea de comandos.

Por ejemplo: -e instance_shape="VM.Standard3.Flex"

Del mismo modo, la versión por defecto de la imagen de Oracle Linux utiliza la variable os_version definida en el archivo `default_vars.yml. Puede modificar este valor transfiriendo la versión principal de Oracle Linux en la línea de comandos.

Por ejemplo: -e os_version="9"

Importante: Espere a que el cuaderno de estrategias se ejecute correctamente y alcance la tarea de pausa. En esta etapa del manual, se ha completado la instalación de Oracle Linux y las instancias están listas. Observe la reproducción anterior, que imprime las direcciones IP públicas y privadas de los nodos que despliega.

Crear un cuaderno de estrategias

Abra una ventana de terminal nueva.
Defina una variable en la instancia remota de git-server.
```
export REMOTE=<ip_address_of_instance>
```
Cree un directorio de proyecto.
```
mkdir ~/myproject
```

Cree un archivo de requisitos.

Oracle Linux Automation Engine utiliza el archivo de requisitos para extraer las recopilaciones o roles necesarios en el proyecto en tiempo de ejecución.

cat << EOF > ~/myproject/requirements.yml 
---
collections:
  - name: oracle.oci
  - name: community.general
EOF

Nota: Para las versiones de Oracle Linux Automation Engine < 2.13.9, puede configurar el archivo de requisitos para extraer la recopilación directamente del repositorio de recopilaciones GitHub.

cat << EOF > ~/myproject/requirements.yml 
---
collections:
  - name: https://github.com/oracle/oci-ansible-collection.git
    type: git
    version: master
  - name: https://github.com/ansible-collections/community.general.git
    type: git
    version: main
EOF

Crear un libro de estrategias.

Este manual consulta el espacio de nombres de almacenamiento de objetos para el arrendamiento de Oracle Cloud Infrastructure. Configuraremos los detalles del arrendamiento más adelante en la interfaz de usuario web de Oracle Linux Automation Manager.
```
cat << EOF > ~/myproject/get_namespace.yml
---
- name: Get namespace name
  hosts: localhost

  tasks:

  - name: get namespace
    oracle.oci.oci_object_storage_namespace_facts:
    register: output

  - name: print namespace
    ansible.builtin.debug:
      msg: ""
EOF
```

Adición del proyecto al control de origen

Inicialice el directorio de trabajo del proyecto en un repositorio de Git.

Antes de inicializar el repositorio, debe realizar algunos pasos de configuración inicial de Git.
1. Defina el nombre de rama por defecto utilizado al inicializar un proyecto.
```
git config --global init.defaultBranch main
```
2. Defina su identidad.
  
  El correo electrónico y el nombre son ejemplos de este tutorial. Utilice su dirección de correo electrónico y nombre cuando trabaje en sus proyectos, ya que git incluye inmutablemente esta información en cada confirmación.
```
git config --global user.email johndoe@example.com
git config --global user.name "John Doe"
```
3. Cambie al directorio de trabajo del proyecto.
```
cd ~/myproject
```
4. Inicialice el directorio como repositorio de Git local.
```
git init
```
  El comando devuelve que inicializó el repositorio de Git vacío.
Compruebe el estado del directorio de trabajo y del área temporal del proyecto.
```
git status
```
El estado del repositorio local indica dos archivos sin seguimiento: get_namespace.yml y requirements.yml.
Agregue y realice un seguimiento de los nuevos archivos en el área temporal.
```
git add --all
```
La opción --all agrega todos los archivos sin seguimiento y modificados al área temporal.
Confirme los cambios actualmente en el área temporal.
```
git commit -m 'initial commit'
```
La opción -m permite agregar un comentario a los cambios confirmados.
Cree e inicialice el repositorio de Git remoto.

Un repositorio remoto es un repositorio compartido que utilizan todos los contribuyentes de proyecto y que se almacena en un servicio de alojamiento de código, como GitHub o un servidor autoalojado.
```
ssh git@$REMOTE "git init -b main --bare /git-server/repos/myproject.git"
```
La opción -b garantiza la inicialización del repositorio remoto mediante una rama denominada main.
Acepte la huella de clave de ECDSA escribiendo yes.
Agregue el nuevo registro de conexión de repositorio remoto.

Agregar la conexión remota al repositorio local le permite utilizarla como un acceso directo con nombre en los comandos de Git.
```
git remote add origin git@$REMOTE:/git-server/repos/myproject.git
```
La ruta después de los dos puntos es la ubicación del directorio del repositorio en el servidor Git remoto.
Verifique el registro de conexión recién agregado.
```
git remote -v
```
La salida muestra el registro de conexión origin que apunta a la ubicación del repositorio de Git remoto para los comandos git fetch y git push.
Transfiera los cambios del repositorio local al repositorio remoto.
```
git push origin main
```
Ahora es posible usar el origen myproject dentro de un proyecto de Oracle Linux Automation Manager.

Crear credenciales de Galaxy de Ansible

Estas credenciales permiten a Oracle Linux Automation Manager extraer la recopilación de OCI Ansible del Galaxy Hub público de Ansible.

Abra una nueva ventana de terminal y configure un túnel SSH a la instancia del nodo olam.
```
ssh -L 8444:localhost:443 oracle@<ip_address_of_instance>
```
Abra un explorador web e introduzca la URL.
```
https://localhost:8444
```
Nota: Apruebe la advertencia de seguridad según el explorador utilizado. Para el explorador Chrome, haga clic en el botón Advanced (Avanzado) y, a continuación, en el enlace Proceed to localhost (unsafe) (Continuar con el host local [no seguro]).
Inicie sesión en la IU web de Oracle Linux Automation Manager. Utilice el nombre de usuario admin y la contraseña admin creados durante el despliegue automatizado.
La interfaz de usuario web se muestra después de una conexión correcta.
Haga clic en Credenciales en la sección Recursos del menú de navegación.
Haga clic en el botón Agregar.
Introduzca o seleccione los siguientes valores en los campos específicos.

Para los campos con una búsqueda o lista de valores, podemos empezar a escribir el valor solicitado y, a continuación, seleccionarlo de la lista.
- Name: My Ansible Galaxy
- Organización: Default
- Tipo de credencial: Token de API de Ansible Galaxy/Automation Hub
Oracle Linux Automation Manager utiliza las credenciales de Ansible Galaxy para facilitar la descarga de roles y recopilaciones mediante el comando ansible-galaxy.
- URL de Galaxy Server: https://galaxy.ansible.com
Revise las entradas y haga clic en el botón Save (Guardar).
Haga clic en Organizations (Organizaciones) en la sección Access (Acceso) del menú de navegación.

La asignación de la credencial de Ansible Galaxy dentro de la organización permite la descarga de la recopilación de Ansible de infraestructura de Oracle Linux desde el proyecto de git.
Haga clic en la organización Default (Por defecto) y haga clic en el botón Edit (Editar).
Seleccione la credencial My Ansible Galaxy en el campo Galaxy Credentials y haga clic en el botón Select (Seleccionar).
Revise y haga clic en el botón Guardar.

Crear credenciales de OCI

Las credenciales de OCI proporcionan información de Oracle Linux Automation Manager sobre el arrendamiento de OCI específico.

Haga clic en Credenciales en el menú de navegación.
Haga clic en el botón Agregar.
Introduzca o seleccione los siguientes valores en los campos específicos.
- Name: My OCI Credentials
- Organización: Default
- Tipo de credencial: Oracle Cloud Infrastructure
La página refresca y solicita la información de configuración de OCI.
Abra una ventana de terminal nueva.
Visualice el contenido del archivo de configuración de OCI.
```
cat ~/.oci/config
```
Utilice los valores que se muestran en el terminal y haga coincidir los campos específicos de la credencial de OCI en la interfaz de usuario web de Oracle Linux Automation Manager.

Utilice el icono situado junto a cada campo para mostrar el valor del pegado.
Obtenga el contenido de la clave privada de API de su usuario de OCI.

En el entorno de prácticas gratuito, puede ejecutar cat ~/.oci/oci.key para obtener esta información y, a continuación, copiar toda la salida, incluidas las líneas BEGIN y END.
Pegue la clave en el campo Private User Key (Clave de usuario privada) en la interfaz de usuario web de Oracle Linux Automation Manager.
Revise y haga clic en el botón Guardar.

Si necesita editar estos valores más adelante, aparecerán cifrados en la interfaz de usuario web. Por lo tanto, para realizar cambios, haga clic en el icono Sustituir junto al campo específico y agregue el nuevo valor para el campo. Repita estos pasos según sea necesario y, a continuación, haga clic en el botón Guardar cuando termine de realizar los cambios.

Creación de un inventario

Haga clic en Inventarios en el menú de navegación.
Haga clic en el botón Agregar y seleccione Agregar inventario en la lista desplegable de valores.
Introduzca o seleccione los siguientes valores en los campos específicos.
- Name: My Local Inventory
- Instance Groups (Grupos de instancias): controlplane
La recopilación de Ansible de Oracle Cloud Infrastructure utiliza una conexión de red de localhost al utilizar Oracle Linux Automation Engine para interactuar con el arrendamiento de OCI.
Revise y haga clic en el botón Guardar.

Agregar credencial de control de origen

Haga clic en Credenciales en el menú de navegación.
Haga clic en el botón Agregar.
Introduzca o seleccione los siguientes valores en los campos específicos.
- Name: Git Server
- Tipo de credencial: Control de origen
La página se refresca y solicita los detalles de tipo.
Introduzca el nombre de usuario del servidor de Git.
- Username: git
Copie y pegue el contenido de la clave privada del servidor de Git en el campo Clave privada de SCM.

El entorno de prácticas gratuito utiliza el archivo ~/.ssh/id_rsa por defecto.
Revise y haga clic en el botón Guardar.

Crear proyecto

Haga clic en Projects (Proyectos) en el menú de navegación.
Haga clic en el botón Agregar.
Introduzca o seleccione los siguientes valores en los campos específicos.
- Name: My Project
- Entorno de ejecución: OLAM EE (2.3)
- Source Control Credential Type (Tipo de credencial de control de origen): Git
La página se refresca y solicita los detalles de tipo.
- URL de control de origen: git@<ip_address_of_instance>:/git-server/repos/myproject.git
- Source Control Branch: main
- Credencial de control de origen: Servidor de Git
El entorno de prácticas libre utiliza la dirección IP del servidor git en el campo Source Control URL (URL de control de origen).
Revise y haga clic en el botón Guardar.
Revise el estado de sincronización del proyecto.

Después de crear un proyecto, la interfaz de usuario web muestra su estado en el resumen de Detalles a medida que comienza la sincronización. El estado pasa de En ejecución a Correcto si la configuración es correcta y se puede acceder al servidor de Git.

Crear plantilla de trabajo

Haga clic en Templates (Plantillas) en el menú de navegación.
Haga clic en el botón Agregar y seleccione Agregar plantilla de trabajo en la lista desplegable de valores.
Introduzca o seleccione los valores necesarios.
- Name: My Template
- Tipo de trabajo: Ejecutar
- Inventario: Mi inventario local
- Proyecto: Mi proyecto
- Entorno de ejecución: OLAM EE (2.3)
- Libro de reproducción: get_namespace.yml
Seleccione las credenciales.

Al seleccionar Credenciales, aparece un cuadro de diálogo emergente Seleccionar credenciales. Seleccione Oracle Cloud Infrastructure en la lista desplegable Categoría seleccionada para mostrar las credenciales de ese tipo.
Seleccione Mis credenciales de OCI y, a continuación, haga clic en el botón Seleccionar.
Revise las entradas de la plantilla de trabajo.
Desplácese hacia abajo por la página y haga clic en el botón Guardar.
Inicie la plantilla.

Inicie un trabajo desde la página de resumen de plantilla haciendo clic en el botón Iniciar.

Si se realiza correctamente, el trabajo se inicia y muestra la salida de la plantilla, incluido el espacio de nombres del arrendamiento de OCI. Puede hacer clic en el enlace Recargar salida para refrescar el panel de salida si es necesario.

Pasos Siguientes

La salida que muestra el espacio de nombres confirma que tiene una configuración de trabajo y un proyecto que demuestra cómo utilizar los cuadernos de estrategias mediante la recopilación de Ansible de Oracle Cloud Infrastructure. Experimente más con la recopilación para desplegar instancias y otros recursos en su arrendamiento.

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de formación gratuita en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.

Para obtener documentación sobre el producto, visite Oracle Help Center.

Título e Información de Copyright

Use OCI Ansible Collection with Oracle Linux Automation Manager

F76744-03