Nota

Este complemento es parte del colección hetzner.hcloud (versión 1.2.1).

Para instalarlo use: ansible-galaxy collection install hetzner.hcloud.

Para usarlo en un libro de jugadas, especifique: hetzner.hcloud.hcloud_server.

  • Sinopsis
  • Requisitos
  • Parámetros
  • Ver también
  • Ejemplos de
  • Valores devueltos

Sinopsis

  • Cree, actualice y administre servidores en la nube en Hetzner Cloud.

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

  • hcloud-python> = 1.0.0

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
api_tokenstring / requerido Este es el token de API para Hetzner Cloud.
copias de seguridadbooleano
    Opciones:

  • no
Habilite o deshabilite las copias de seguridad para el servidor dado.
centro de datosstring Centro de datos del servidor No se requiere localización se da y el servidor no existe.
delete_protectionbooleano
    Opciones:

  • no
Proteger el servidor para su eliminación. Debe ser el mismo que rebuild_protection.
punto finalstring Defecto:
“https://api.hetzner.cloud/v1”
Este es el punto final de API para Hetzner Cloud.
force_upgradebooleano
    Opciones:

  • no
Forzar la actualización del servidor Apague el servidor si se está ejecutando en la actualización.
identificaciónentero El ID del servidor de Hetzner Cloud a administrar.Sólo se requiere si no hay servidor nombre es dado
imagenstring Imagen desde la que se debe crear el servidor. Se requiere si el servidor no existe.
etiquetasdiccionario Etiquetas definidas por el usuario (key-pares de valores).
localizaciónstring Ubicación del servidor Requerido si no centro de datos se da y el servidor no existe.
nombrestring El nombre del servidor de Hetzner Cloud que se va a administrar. Solo se requiere si no hay servidor. identificación se da o no existe un servidor.
rebuild_protectionbooleano
    Opciones:

  • no
Proteja el servidor para la reconstrucción. Debe ser el mismo que delete_protection.
el modo de rescatestring Agregue el tipo de sistema de rescate Hetzner en el que desea que se inicie el servidor.
Tipo de servidorstring El tipo de servidor del servidor de Hetzner Cloud que se va a administrar. Se requiere si el servidor no existe.
ssh_keyslista / elementos =string Lista de SSH key nombres key los nombres corresponden al SSH keys configurado para el acceso a su cuenta de Hetzner Cloud.
estadostring
    Opciones:

  • ausente
  • regalo
  • reiniciado
  • empezado
  • interrumpido
  • reconstruir
Estado del servidor.
upgrade_diskbooleano
    Opciones:

  • no
Cambie el tamaño del disco, al cambiar el tamaño de un servidor. Si desea degradar el servidor más adelante, este valor debe ser Falso.
datos del usuariostring Los datos del usuario se pasarán al servidor en el momento de la creación. Solo se utilizan si el servidor no existe.
volúmeneslista / elementos =string Lista de ID de volúmenes que se deben adjuntar al servidor en la creación del servidor.

Ver también

Ver también

Documentación para la API de Hetzner Cloud

Referencia completa para la API de Hetzner Cloud.

Ejemplos de

-name: Create a basic server
  hcloud_server:name: my-server
    server_type: cx11
    image: ubuntu-18.04state: present

-name: Create a basic server with ssh key
  hcloud_server:name: my-server
    server_type: cx11
    image: ubuntu-18.04location: fsn1
    ssh_keys:-[email protected]state: present

-name: Resize an existing server
  hcloud_server:name: my-server
    server_type: cx21
    upgrade_disk: yes
    state: present

-name: Ensure the server is absent (remove if needed)
  hcloud_server:name: my-server
    state: absent

-name: Ensure the server is started
  hcloud_server:name: my-server
    state: started

-name: Ensure the server is stopped
  hcloud_server:name: my-server
    state: stopped

-name: Ensure the server is restarted
  hcloud_server:name: my-server
    state: restarted

-name: Ensure the server is will be booted in rescue mode and therefore restarted
  hcloud_server:name: my-server
    rescue_mode: linux64
    state: restarted

-name: Ensure the server is rebuild
  hcloud_server:name: my-server
    image: ubuntu-18.04state: rebuild

Valores devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Llave Devuelto Descripción
hcloud_servercomplejo Siempre La instancia del servidor
ventana_respaldobooleano siempre Ventana de tiempo (UTC) en la que se ejecutará la copia de seguridad, o null si las copias de seguridad no están habilitadas
Muestra:22-02
centro de datosstring siempre Nombre del centro de datos del servidor
Muestra:fsn1-dc14
delete_protectionbooleanoagregado en 0.1.0 de hetzner.hcloud siempre Verdadero si el servidor está protegido para su eliminación
identificaciónentero siempre Identificador numérico del servidor
Muestra:1937415
ipv4_addressstring siempre Dirección IPv4 pública del servidor
Muestra:116.203.104.109
ipv6string siempre Red IPv6 del servidor
Muestra:2a01: 4f8: 1c1c: c140 :: / 64
etiquetasdiccionario siempre Etiquetas definidas por el usuario (keypares de valores)
localizaciónstring siempre Nombre de la ubicación del servidor
Muestra:fsn1
nombrestring siempre Nombre del servidor
Muestra:mi-servidor
rebuild_protectionbooleanoagregado en 0.1.0 de hetzner.hcloud siempre Verdadero si el servidor está protegido para la reconstrucción
rescue_enabledbooleano siempre Verdadero si el modo de rescate está habilitado, el servidor se iniciará en el sistema de rescate en el próximo reinicio
Tipo de servidorstring siempre Nombre del tipo de servidor del servidor
Muestra:cx11
estadostring siempre Estado del servidor
Muestra:corriendo

Autores

  • Lukas Kaemmerling (@LKaemmerling)