¿Cómo desplegar código personalizado en una instancia dedicada?

Athento permite ejecutar código personalizado en instancias dedicadas.

Entre el código que permite desplegar están:

1. Operaciones
2. Comandos
3. Plantillas HTML
4. Hooks de API
5. Máscaras de bandejas

Para trabajar con código personalizado, se deben realizar los siguientes pasos:

1. Disponer de un repositorio GIT
2. Subir el código con la misma estructura que puede verse en el directorio /var/www/athentose
3. Enviar un correo a soporte@athento.com facilitando la URL del repositorio GIT y facilitando credenciales de lectura, indicando sobre qué instancia se solicita realizar el despliegue del código personalizado. Puntualmente, puede indicarse la rama que se quiere usar para los despliegues y la frecuencia de despliegue automático.

Actualizaciones

Las actualizaciones del código se realizarán de forma automática, normalmente cada hora o menos.

Por lo tanto, debe tenerse en cuenta que cualquier código subido a la rama principal de dicho repositorio, será actualizado automáticamente. Es recomendable entonces usar ramas diferentes para el desarrollo y trabajar con Pull Requests para hacer merge del codigo en la rama principal.

Los desarrolladores son responsables de subir el código definitivo al repositorio. La subida de código al repositorio no forma parte del soporte.

Puntualmente, puede solicitarse a Athento la actualización manual del código en casos especiales. En estos casos, el soporte de Athento se limitará a realizar los siguientes comandos:

1. "git pull", para desplegar el nuevo código
2. "./scripts/soft_reload.sh" para que se apliquen los cambios

Los tickets de soporte deben llevar por título "Actualización código custom en instancia", indicando claramente la instancia para la que se solicita la actualización.

Cómo desplegar el código como aplicación Django

1. Crear enlace simbólico del proyecto en /var/www/athentose/athentose
2. Configurar el fichero /var/www/athentose/athentose/settings_config/custom/settings_custom_apps.py

Ejemplo de comando para crear el enlace simbólico

ln -s /var/www/athentose/athentose/custom/MyApp /var/www/athentose/athentose

Ejemplo de código para settings_custom_apps.py

CUSTOM_INSTALLED_APPS = ('MyApp', )
INSTALLED_APPS += CUSTOM_INSTALLED_APPS

Comandos útiles para subir código al repositorio

Si se trabaja desde un entorno de UAT sobre código personalizado, estos comando son útiles para subir el código al repositorio:

• git add: para añadir nuevos archivos al control de versiones
• git commit: para confirmar cambios en el repositorio
• git push: para subir los cambios al repositorio 

Algunos recursos sobre GIT

• https://www.w3schools.com/git/
• https://product.hubspot.com/blog/git-and-github-tutorial-for-beginners