gantsign.kops

Descripción general Versiones Perspectivas

Rol de Ansible: kops

Rol para descargar e instalar kops, la herramienta para configurar clústeres de Kubernetes en producción.

Requisitos

Ansible >= 2.8
Distribución de Linux
- Familia Debian
  - Debian
    - Jessie (8)
    - Stretch (9)
  - Ubuntu
    - Xenial (16.04)
    - Bionic (18.04)
- Familia RedHat
  - CentOS
    - 7
- Nota: otras versiones probablemente funcionen, pero no han sido probadas.

Variables del Rol

Las siguientes variables cambiarán el comportamiento de este rol (los valores predeterminados se muestran a continuación):

# número de versión de kops
kops_version: 'v1.18.2'

# Espejo para descargar kops
kops_mirror: 'https://github.com/kubernetes/kops/releases/download/{{ kops_version }}'

# Directorio para almacenar archivos descargados de kops
kops_download_dir: "{{ x_ansible_download_dir | default(ansible_env.HOME + '/.ansible/tmp/downloads') }}"

Ejemplo de Playbook

- hosts: servers
  roles:
    - role: gantsign.kops

Autocompletado para Zsh

Usando Ansible

Recomendamos usar el rol gantsign.antigen para habilitar el autocompletado para kops (esto debe configurarse para cada usuario).

- hosts: servers
  roles:
    - role: gantsign.kops

    - role: gantsign.antigen
      users:
        - username: ejemplo
          antigen_libraries:
            - name: oh-my-zsh
          antigen_bundles:
            - name: kops

Usando Antigen

Si prefieres usar Antigen directamente, añade lo siguiente a tu configuración de Antigen:

antigen bundle kops

Configuración manual

Para configurar Zsh manualmente, añade lo siguiente a tu .zshrc:

eval "$(kops completion zsh)"

Más Roles de GantSign

Puedes encontrar más roles de GantSign en Ansible Galaxy.

Desarrollo y Pruebas

Este proyecto utiliza Molecule para ayudar en el desarrollo y las pruebas; el rol se prueba unitariamente usando Testinfra y pytest.

Para desarrollar o probar, necesitarás tener instalado lo siguiente:

Linux (por ejemplo, Ubuntu)
Docker
Python (incluyendo python-pip)
Ansible
Molecule

Debido a que lo anterior puede ser complicado de instalar, este proyecto incluye Molecule Wrapper. Molecule Wrapper es un script de shell que instala Molecule y sus dependencias (excepto Linux) y luego ejecuta Molecule con el comando que le pases.

Para probar este rol usando Molecule Wrapper, ejecuta el siguiente comando desde la raíz del proyecto: