Explicación en detalle de los tags disponibles en el kit de Ansible
Genérico |
|
Ejecución sin tag |
Se despliega Anjana + persistencias sin datos de ejemplo. |
anjana-sample |
Despliega Anjana + persistencias con datos de ejemplo. |
platform |
Prepara la máquina con todo lo necesario para el correcto funcionamiento de anjana, como crear el usuario y grupo, crear la carpeta temporal, ajustar los alias de /etc/hosts, instalar jq/unzip/iproute2 y comprobar la conexión al repositorio. |
download |
El modo local requiere tener descargado todo el software previamente. Este tag permite descargarlo todo.
Se lanza en modo manager y descarga jars, set de datos, software, utilidades que requiere Anjana para ser copiado a otro nodo Ansible sin conectividad a internet y desplegar Anjana en modo local. |
ansible-user |
Permite la creación de un usuario con grupo y llave (key) en todos los nodos, autorizando su uso, específico para la ejecución de ansible.
Un usuario con permisos de administrador para acceder a directorios y ficheros (como root) es necesario para lanzar este tag. |
Microservicios |
|
portuno kerno zeus drittesta minerva viator hermes tot horus |
Despliega el microservicio seleccionado.
Entre las tareas que se realizan, se incluyen respaldar, borrar y descargar los jars, y crear o sobreescribir el existente descriptor del servicio. |
anjana-ui
|
Despliega Apache2 con los frontales / y /configpanel. Crea o sobreescribe los archivos de configuración de Apache para ambos front. |
Plugins |
|
tot-plugin-aws-glue tot-plugin-aws-iam tot-plugin-aws-s3 tot-plugin-azure-ad tot-plugin-azure-storage tot-plugin-gcp-bigquery tot-plugin-gcp-iam tot-plugin-gcp-storage tot-plugin-jdbc tot-plugin-jdbc-denodo tot-plugin-jdbc-oracle tot-plugin-jdbc-redshift tot-plugin-jdbc-sqlserver tot-plugin-ldap tot-plugin-aqtiva tot-plugin-powerbi tot-plugin-ranger tot-plugin-tableau |
Despliega el plugin seleccionado.
Entre las tareas que se realizan, se incluyen respaldar, borrar y descargar los jars, y crear o sobreescribir el existente descriptor del servicio. |
Actualizaciones |
|
update |
Ejecuta todas las tareas de actualización de los jar, frontales y cdn. |
update-config |
Actualiza/despliega los archivos de configuración de los microservicios.
⚠️IMPORTANTE: Reemplaza todas las configuraciones existentes con los templates presentes en el inventario. |
update-vhosts |
Actualiza/despliega los archivos de configuración de Apache2.
⚠️IMPORTANTE: Reemplaza la configuración de apache2 con los templates presentes en el inventario. |
update-services |
Actualiza/despliega los descriptores de servicio de los microservicios de Anjana.
⚠️IMPORTANTE: Reemplaza todos los descriptores de servicio con los templates presentes en el inventario. |
update-portuno update-kerno update-zeus update-drittesta update-minerva update-viator update-hermes update-tot update-horus |
Actualiza el jar del microservicio elegido. |
update-anjana-ui |
Actualiza los frontales / y /configpanel, y descarga el cdn sin sobreescribir si se encuentra algún conflicto. |
update-tot-plugin-aws-glue update-tot-plugin-aws-iam update-tot-plugin-aws-s3 update-tot-plugin-azure-ad update-tot-plugin-azure-storage update-tot-plugin-gcp-bigquery update-tot-plugin-gcp-iam update-tot-plugin-gcp-storage update-tot-plugin-jdbc update-tot-plugin-jdbc-denodo update-tot-plugin-jdbc-oracle update-tot-plugin-jdbc-redshift update-tot-plugin-jdbc-sqlserver update-tot-plugin-ldap update-tot-plugin-aqtiva update-tot-plugin-powerbi update-tot-plugin-ranger update-tot-plugin-tableau |
Actualiza el jar del plugin elegido. |
Persistencias |
|
persistences |
Instala todas las persistencias seleccionadas en el all.yml. |
persistences-sample |
Instala todas las persistencias + datos de ejemplo seleccionadas en el all.yml. |
delete-persistences |
Borra las persistencias instaladas seleccionadas en el all.yml
⚠️IMPORTANTE: Esta acción borra también todo el contenido de cada persistencia, es necesario un backup/export previo. |
update-persistences |
Borra las persistencias instaladas seleccionadas en el all.yml y después instala la última versión indicada en los archivos de variables de cada persistencia.
⚠️IMPORTANTE: Esta acción borra también todo el contenido de cada persistencia, es necesario un backup/export previo. |
postgresql zookeeper solr apacheds minio |
Instala todas la persistencia escogida. |
export import |
Ejecuta la exportación e importación de datos de un entorno Anjana (MinIO y BBDD). |
import-bbdd import-s3 |
Ejecuta la importación de datos en un entorno Anjana de las persistencias seleccionadas. |
backup-dump |
Ejecuta un dump de las persistencias + config y lo sube al bucket anjanabackups especificado. |
restore-dump |
Permite restaurar un dump disponible en el bucket anjanabackups eligiendo de entre los disponibles. |
dump-cron |
Despliega un cron que ejecutará ansible con el tag backup-dump automáticamente. Es configurable en persistencesutilityhosts.yml. |
clone deploy |
Clone ejecuta la exportación de datos de un entorno Anjana, generando un comprimido .tgz. Deploy despliega los datos clonados desde un comprimido existente.
Incluye persistencias (MinIO y BBDD) y la configuración. |
deploy-bbdd deploy-s3 deploy-config |
Ejecuta el despliegue de datos en un entorno Anjana de las persistencias seleccionadas y/o la configuración |
skip-backup |
Se usa lanzándolo con skip-tags (--skip-tags skip-backup), para evitar que se haga backup durante la ejecución de ansible. |
backup backup-persistences backup-config |
Realiza el backup de la configuración y los datos de las persistencias. Puede lanzarse en conjunto, o configuración y persistencias por separado. No combinable con export o deploy. |
restore restore-s3 restore-bbdd restore-config |
Permite restaurar la persistencia y/o configuración elegidos desde el último backup disponible.
En caso de no haber ningún backup disponible, se mostrará un aviso y se detendrá la ejecución. |
delete delete-bbdd delete-s3 delete-solr delete-config |
Permite borrar los datos de la persistencia y/o configuración elegidos |
insert insert-bbdd insert-s3 |
Se realiza un insert con el set de datos escogido en all.yml en MinIO y BBDD para las persistencias seleccionadas. |
reset reset-bbdd reset-s3 |
Realiza un borrado con backup previo y reinserción de datos de las persistencias elegidas. |
Utilidades |
|
ansible |
Despliega o actualiza el kit de ansible. Instala las colecciones y dependencias necesarias. |
clean |
Borra lo descargado en la carpeta temporal. |
post-upgrade-cleanup |
Borra todos los servicios, carpetas, ficheros, etc… deprecados de la versión 23.1.
|
check-health |
Verifica el estado de salud de los microservicios, plugins y persistencias desplegados en el entorno. |
start |
Arranca de forma ordenada todos los microservicios. |
stop |
Detiene de forma ordenada toda la instalación de Anjana, comenzando por los microservicios dependientes de otros y terminando en las persistencias. |
restart |
Realiza una parada y luego un arranque de forma ordenada de todo Anjana. |
restart-microservices |
Reinicia los servicios de Anjana sin ordenar. |
start-zookeeper start-postgresql start-minio start-solr start-portuno start-zeus start-kerno start-minerva start-horus start-viator start-hermes start-tot start-anjana-ui start-tot-plugin-aws-glue start-tot-plugin-aws-iam start-tot-plugin-aws-s3 start-tot-plugin-azure-ad start-tot-plugin-azure-storage start-tot-plugin-gcp-bigquery start-tot-plugin-gcp-iam start-tot-plugin-gcp-storage start-tot-plugin-jdbc start-tot-plugin-jdbc-denodo start-tot-plugin-jdbc-oracle start-tot-plugin-jdbc-redshift start-tot-plugin-jdbc-sqlserver start-tot-plugin-ldap start-tot-plugin-aqtiva start-tot-plugin-powerbi start-tot-plugin-ranger start-tot-plugin-tableau |
Arranca el microservicio seleccionado iniciando primero de forma selectiva y ordenada todos los microservicios y persistencias que necesita para funcionar. |
stop-zookeeper stop-postgresql stop-minio stop-solr stop-portuno stop-zeus stop-kerno stop-minerva stop-horus stop-viator stop-hermes stop-tot stop-anjana-ui stop-tot-plugin-aws-glue stop-tot-plugin-aws-iam stop-tot-plugin-aws-s3 stop-tot-plugin-azure-ad stop-tot-plugin-azure-storage stop-tot-plugin-gcp-bigquery stop-tot-plugin-gcp-iam stop-tot-plugin-gcp-storage stop-tot-plugin-jdbc stop-tot-plugin-jdbc-denodo stop-tot-plugin-jdbc-oracle stop-tot-plugin-jdbc-redshift stop-tot-plugin-jdbc-sqlserver stop-tot-plugin-ldap stop-tot-plugin-aqtiva stop-tot-plugin-powerbi stop-tot-plugin-ranger stop-tot-plugin-tableau |
Detiene el microservicio seleccionado parando primero de forma selectiva y ordenada todos los microservicios que dependen de él. |
uninstall |
Procede a una desinstalación completa de Anjana, incluido el software de terceros que se haya desplegado con el kit, en el inventario seleccionado.
La carpeta de Ansible no se borra porque impediría la finalización de la ejecución. Se mantienen los backups y las exportaciones existentes. |
unlock-schemas |
Desbloquea los esquemas de Anjana que se encuentren en el estado Waiting for changelog lock. |
swap |
Permite configurar un archivo swap de 4GB para extender la memoria. |
Seguridad |
|
update-whitelist |
Permite actualizar la lista de IPs permitidas de acceso sin desplegar todo el frontal. |
certificate-deploy |
Permite el despliegue del certificado renovado para los microservicios, los frontales y las persistencias.
⚠️IMPORTANTE: El nuevo certificado debe encontrarse en /opt/common/anjana-certs disponible antes de la ejecución de este tag. |
Logs y Auditoría |
|
export-log |
Exporta los logs de los microservicios de Anjana a la carpeta /opt/anjana-logs/<microservicio>.log.
Por defecto los últimos 5 días pero configurable en tiempo de ejecución con -e '{"log": {"since": "2 day ago"}}' |
export-log-s3 |
Recoge los logs ya disponibles de la carpeta /opt/anjana-logs y los sube al bucket anjanalogs configurado en el all.yml. |
log-rotate |
Permite ajustar el tamaño máximo de logs de sistema a 2GB y el número máximo de archivos a 2 parar ahorrar disco. Por defecto aplicado por anjana-platform. |
Extras |
|
grafana |
Despliega Grafana junto a los dashboards y datasources para la visualización de métricas sobre los datos gobernados. |
update-grafana-dashboards |
Permite actualizar los dashboards de Grafana desde los templates sin desplegar Grafana nuevamente.
⚠️IMPORTANTE: Reemplaza todos los dashboards existentes con los templates presentes en el inventario. |