Rol de Ansible: ZeroTier

Este rol de Ansible agrega el repositorio de ZeroTier e instala el paquete zerotier usando el gestor de paquetes de tu sistema. Dependiendo de las variables proporcionadas, este rol también puede agregar y autorizar nuevos miembros a redes ZeroTier (existentes), y decirle al nuevo miembro que se una a la red.

Si necesitas un rol más flexible y genérico para ZeroTier, revisa ajaykumar4.zerotier.

Requisitos

Técnicamente, este rol no tiene requisitos. Si se ejecuta sin establecer ninguna variable, solo realizará las tareas de instalación. Las siguientes variables afectan el comportamiento del rol:

zerotier_network_id: cuando se establece, se indica a los hosts que se unan a esta red.
zerotier_api_accesstoken: cuando se establece, el rol puede manejar la autenticación y configuración de miembros usando la API de ZeroTier.

Variables del Rol

zerotier_network_id

Tipo: cadena
Valor por defecto:
Descripción: El ID de red de 16 caracteres a la que deben unirse los nuevos miembros. El nodo no se unirá a ninguna red si se omite.

zerotier_member_register_short_hostname

Tipo: booleano
Valor por defecto: false
Descripción: Por defecto, se usará inventory_hostname para nombrar a un miembro en una red. Si se establece en true, se usará inventory_hostname_short en su lugar.

zerotier_member_ip_assignments

Tipo: lista
Valor por defecto: []
Descripción: Una lista de direcciones IP para asignar a este miembro. Si se omite, al miembro se le asignará automáticamente una dirección en la red.

zerotier_member_description

Tipo: cadena
Valor por defecto: ""
Descripción: Descripción opcional para un miembro.

zerotier_api_accesstoken

Tipo: cadena
Valor por defecto: ""
Descripción: El token de acceso necesario para autorizar con la API de ZeroTier. Puedes generar uno en la configuración de tu cuenta en https://my.zerotier.com/. Si se omite, el nuevo miembro que se una no será autorizado automáticamente.

zerotier_api_url

Tipo: cadena
Valor por defecto: https://my.zerotier.com
Descripción: La URL donde se encuentra la API de Zerotier. Debe usar el protocolo HTTPS.

zerotier_api_delegate

Tipo: cadena
Valor por defecto: localhost
Descripción: Opción para delegar tareas para llamadas a la API de Zerotier. Esto es útil en situaciones donde las llamadas a la API solo pueden hacerse desde un servidor de gestión en una lista blanca, por ejemplo.

Uso

---

Primero, crea un nuevo directorio basado en el directorio sample dentro del directorio inventory:

cp -R inventory/sample inventory/my-cluster

En segundo lugar, edita inventory/my-cluster/hosts.ini para que coincida con la información del sistema que recopilaste anteriormente.

Ejemplo de Inventario

    [servers]
    pi-master
    pi-worker01
    jetson-worker01

    [master]
    pi-master

    [nodes]
    pi-worker01
    jetson-worker01

    [master:vars]
    zerotier_member_description='Nodo Maestro de Kubernetes Pi'

    [nodes:vars]
    zerotier_member_description='Nodos Trabajadores de Kubernetes Pi'

    [servers]
    pi-master hostname=pi-master ansible_host=192.168.0.82 ansible_user=pi ansible_sudo_pass=password zerotier_member_description="Nodo Maestro de Kubernetes Pi"
    pi-worker01 ansible_port=22 hostname=pi-worker01 ansible_host=192.168.0.176 ansible_user=pi ansible_sudo_pass=password zerotier_member_description="Nodo Trabajador de Kubernetes Pi01"
    jetson-worker01 ansible_port=22 hostname=jetson-worker01 ansible_host=192.168.0.227 ansible_user=jetson ansible_sudo_pass=password zerotier_member_description="Nodo Trabajador de Kubernetes Jetson01"

En tercer lugar, edita inventory/my-cluster/site.yml para que coincida con la información de zerotier que recopilaste anteriormente.

Ejemplo de Playbook

    - hosts: servers
      vars:
         zerotier_network_id: < id de red >
         zerotier_api_accesstoken: < token de acceso >
         zerotier_register_short_hostname: true

      roles:
         - ajaykumar4.zerotier

Inicia el aprovisionamiento del clúster usando el siguiente comando:

ansible-playbook inventory/my-cluster/playbook.yml -i inventory/my-cluster/hosts.ini