Instalación
Breadcrumbs

CheatSheets

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.
✅RECOMENDADO: una vez finalizada la actualización de forma exitosa a 25.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.