DigitalOcean proporciona una API como alternativa a su panel de control en la nube basado en web. El cliente oficial de línea de comandos doctl ofrece un contenedor intuitivo para la API. Puede administrar sus recursos de DigitalOcean utilizando una interfaz programática fácilmente programable.
Instalación
Doctl está disponible en sistemas Windows, macOS y Linux. Se admiten una variedad de métodos de instalación según la plataforma. Todos los sistemas pueden descargar la última versión. directamente desde GitHub.
La mayoría de las distribuciones de Linux incluyen doctl en sus repositorios de paquetes. También se ofrece como Snap en distribuciones con soporte Snap. El mecanismo de instalación preferido es utilizar un administrador de paquetes, ya que lo mantendrá actualizado con las nuevas versiones.
DigitalOcean también proporciona contenedores Docker oficiales en Docker Hub. Son ideales para un uso único en entornos compatibles con Docker. Las instrucciones sobre el uso de la imagen de Docker se pueden encontrar en su Página de Docker Hub; en general el uso es idéntico al de una instalación directa.
Crear un token de acceso
Debe conectar doctl a su cuenta de DigitalOcean antes de comenzar a utilizar la herramienta. La autenticación es persistente una vez configurada, por lo que no necesitará proporcionar credenciales con cada comando.
Comience iniciando sesión en su cuenta de DigitalOcean. Haga clic en el enlace “API” en la parte inferior de la barra lateral. En “Tokens de acceso personal”, haga clic en el botón “Generar nuevo token”. Asigne un nombre a su token y habilite los ámbitos de lectura y escritura.
Una vez creado su token, su valor se mostrará en el panel de control. Guárdelo ahora ya que no será posible recuperarlo más tarde. Deberá crear un nuevo token si se olvida su valor.
Conexión a su cuenta
Ya puedes volver a tu terminal. Utilice el token de acceso generado para conectar doctl a su cuenta:
doctl auth init
Se le pedirá que ingrese el token de acceso. Suponiendo que la validación sea exitosa, doctl guardará sus credenciales. Se enviarán automáticamente con comandos posteriores. Los archivos de configuración se guardan dentro del
.config/doctl
directorio en su carpeta de inicio.
Probando su configuración
Ahora debería poder interactuar exitosamente con su cuenta de DigitalOcean.
Intenta correr
doctl account get
para verificar que los detalles de su cuenta se puedan recuperar.
Interactuar con los recursos de DigitalOcean
doctl le permite interactuar con casi todos los recursos disponibles de DigitalOcean. Hay demasiadas posibilidades para cubrirlas exhaustivamente en un artículo, por lo que nos limitaremos a detallar algunos comandos de uso común.
- doctl compute – Comando de alto nivel para interactuar con una variedad de tipos de recursos. Incluye droplets, dominios, volúmenes, copias de seguridad, instantáneas, imágenes, firewalls y equilibradores de carga.
- doctl compute droplet – Te permite interactuar con Droplets. Intentar doctl compute droplet list
para enumerar todas sus gotas, o
doctl compute droplet create
para crear un droplet básico de Ubuntu en el centro de datos LON1. Una variedad de otros subcomandos brindan opciones de administración completas.
- doctl databases db – Interactuar con bases de datos dentro de un clúster de bases de datos. Usar doctl databases db list
para recuperar bases de datos existentes y
doctl databases db create
crear. Otros comandos relacionados le permiten escalar sus clústeres de bases de datos.
- doctl kubernetes – Este espacio de nombres de comando le permite administrar sus clústeres de Kubernetes. Una gran cantidad de subcomandos le permiten configurar nodos, grupos de nodos, versiones de clústeres y conexiones de registro de contenedores.
- doctl registry – Gestiona su Registro de contenedores de DigitalOcean, incluidas opciones para crear, eliminar y enumerar registros y contenedores. También puede invocar o cancelar el proceso de recolección de basura para liberar espacio de almacenamiento.
Hay muchas funciones disponibles; es recomendable consultar el documentación oficial para obtener la lista completa de comandos y opciones. Generalmente, cualquier punto final de la API de DigitalOcean tiene un comando doctl equivalente.
Explorar los comandos disponibles se simplifica gracias a la extensa documentación incorporada. Ejecutar un comando de nivel superior como
doctl compute
sin ningún argumento se mostrará una lista de todos los subcomandos disponibles. Esto permite el descubrimiento rápido de funciones y significa que no es necesario guardar toda la lista en la memoria.
Además, doctl admite la finalización automática de comandos en los shells más populares. Añadiendo
source
para usted
~/.profile
El archivo suele ser suficiente para habilitar esto. Sustituto
bash
para tu propio caparazón. Puede encontrar orientación específica de Shell en el documentos docentes.
Uso de varias cuentas (contextos)
doctl proporciona soporte optimizado para múltiples cuentas de usuario de DigitalOcean. Puede definir “contextos” autenticados independientes entre los que puede alternar utilizando el
bandera o la
DIGITALOCEAN_CONTEXT
Variable ambiental.
Para agregar un contexto, use el siguiente comando:
doctl auth init –context my-context
Este es el mismo comando de autenticación que vimos antes, esta vez modificado para usar el contexto my-context. El contexto se crea automáticamente si aún no existe. Cuando no se especifica ningún contexto, se utiliza el contexto predeterminado.
Establecer valores de configuración predeterminados
Puede establecer valores predeterminados para la mayoría de las opciones e indicadores utilizando el archivo de configuración. Esto normalmente reside en ~/.config/doctl/config.yaml.
Para definir un valor de configuración, agréguelo al archivo usando el formato categoría.command.subcommand.flag: valor.
compute.droplet.create.size: s-1vcpu-1gb
La configuración anterior establecería de forma predeterminada todas las creaciones de droplets en un tipo de s-1vcpu-1gb.
Los valores predeterminados se pueden anular en cualquier momento pasando un nuevo valor al indicador de la línea de comando como de costumbre.
Formatos de salida
doctl generalmente emite resultados como tablas y listas legibles por humanos. Si planea utilizar la herramienta dentro de scripts o desea información más detallada, puede pasar –output json para obtener el JSON sin formato de la API de DigitalOcean.
Puede personalizar los campos que se devuelven en las tablas utilizando el indicador –format. Ejecute el comando original y tome nota de los nombres de las columnas en su salida. Puede pasarlos como una lista separada por comas a –format, eliminando cualquier espacio que aparezca en los nombres presentados. Solo se incluirán los campos proporcionados cuando ejecute el comando modificado. Simplifica las secuencias de comandos y le brinda un punto de partida para crear sus propias herramientas de monitoreo y alertas.
DigitalOcean actualiza la utilidad periódicamente. Admite casi todas las operaciones API y tipos de recursos. Una excepción notable es el almacenamiento de objetos de Spaces; Como es compatible con Amazon S3, DigitalOcean le recomienda utilizar una utilidad de administración específica de S3.
Puede encontrar documentación doctl completa en DigitalOcean sitio de documentos. El software también es de código abierto, por lo que puedes contribuir con tus propias mejoras. repositorio de GitHub.
Resumen del Contenido
