Solicitud de despliegue

Alta de Ticket

La siguiente documentación describe el proceso para solicitar el alta de una aplicación a través del portal mda.andreani.com.

Para el despliegue de una nueva aplicación, es necesario generar un ticket dirigido a la ticketera de DevOps, seleccionando la subcategoría CICD.

Lenguajes y Plantillas

Se especifican los lenguajes, frameworks y templates disponibles para el desarrollo de aplicaciones:

Lenguaje	Framework	Template
C#	.NET	Web API
		Worker
	Orleans	Web API
Javascript	React	⚠ CRA
		⚠ CRA - Módulo
		⚠ CRA - Shell
		⚠ Vite
		⚠ Vite - Módulo
		⚠ Vite - Shell
		RsBuild SPA
		RsBuild - Módulo
		RsBuild - Shell
	Next.js	⚠ CRA -nextjs
		Nexjs
		Nexjs - Módulo
		Nexjs - Shell
GO	Gin	Web API
		Worker
Python	Flask	Web API
	Databricks	TTL
		GraphQl

Atención

⚠ Está deprecado. Solo es posible migrar aplicaciones existentes; no se permite solicitar la creación de nuevas aplicaciones con este framework.

Proyectos

Un proyecto es un agrupador de aplicaciones o servicios que representa un concepto de producto. Puede incluir varios equipos de desarrollo y varias aplicaciones.

El nombre del proyecto sirve como identificador y agrupador de servicios y aplicaciones, y también se utiliza como namespace para el despliegue de las aplicaciones.

Ejemplos de proyectos: DMS, WOS, Tracking, Notificaciones.

Aplicación

La aplicación se refiere al servicio web, worker, etc., que se instala en los servidores. El nombre de la aplicación no debe incluir indicativos de tecnología o equipo de desarrollo.

• Nombres incorrectos: dotnet-usuario-api, react-usuario, tyd-usuario.
• Nombres correctos: usuario-api, usuario-ui.

El nombre de la aplicación se usa como referencia en OpenShift, para generar rutas, filtrar logs, entre otras funciones.

Equipos de Desarrollo

Los equipos de desarrollo se organizan en tres grupos de GitHub, cada uno con diferentes permisos sobre el repositorio de la aplicación:

1. Equipo de Desarrollo: Incluye a los miembros activos del equipo de desarrollo, con permisos para trabajar en el repositorio.
2. Equipo de Revisores: Compuesto principalmente por Líderes Técnicos y desarrolladores Sr. seleccionados por el Líder Técnico. Tienen permisos para revisar y aprobar Pull Requests y aprobar despliegues en ambientes de desarrollo.
3. Equipo Admin: Reservado para los propietarios del repositorio, incluyendo a aquellos con cargos jerárquicos en el equipo. Pueden aprobar despliegues a producción y poseen todas las capacidades de los equipos anteriores. Deben ser Jefes, o líderes técnicos previamente aprobados por el jefe.

Solicitud de Creación de Aplicación

Para crear una nueva aplicación, es necesario solicitar la creación del repositorio con la configuración de despliegue y el template adecuado.

Info

Actualmente, este proceso es realizado por el equipo de DevOps. Próximamente, se habilitará a los equipos de desarrollo.

Template de Solicitud

Estimadxs, ¿cómo están?

Estamos desarrollando una nueva app y necesitamos crear las siguientes aplicaciones:

Organización GitHub: // Organización donde trabajas.
Nombre del Proyecto: {nombre del proyecto}
Nombre de la Aplicación: {nombre de la aplicación}
Lenguaje:
Framework:
Template:
Equipo: {equipo asociado} // Si el proyecto es nuevo, el equipo de DevOps se comunicará para formar los equipos correspondientes.
Board de Jira: //El id de tablero de Jira asociado a este servicio/repositorio.
Descripción de la aplicación: // Opcional, pero recomendable

Board de Jira: El id de tablero de Jira asociado a este servicio/repositorio. Por ejemplo Esta resaltado en rojo lo que sería el Id del tablero:

Solicitud de Migración de Aplicación

Una migración se considera cuando el repositorio y/o aplicación ya existe y no fue generada por el equipo de DevOps o la herramienta GitOpsPlatform.

Pre-requisitos

1. La rama por defecto del repositorio debe llamarse main.
2. El repositorio debe seguir una estructura de carpetas que incluya un directorio src en el root, conteniendo los archivos de código.
3. Debe existir un archivo Dockerfile en el directorio root.
4. Para proyectos .NET, se requiere un archivo *.sln en el root. Para proyectos Javascript, se necesita un package.json en el mismo directorio.

Tip

Consulte los templates de arquitectura para ejemplos de organización de carpetas.

Template de Solicitud

Estimadxs, ¿cómo están?

Solicitamos las configuraciones necesarias para el despliegue de las siguientes aplicaciones:

Repositorio: {url del repositorio}
Nombre del Proyecto: {nombre del proyecto}
Nombre de la Aplicación: {nombre de la aplicación}
Lenguaje:
Framework:
Template:
Equipo: {equipo asociado} // Si el proyecto es nuevo, el equipo de DevOps se comunicará para formar los equipos correspondientes.
Board de Jira: //El id de tablero de Jira asociado a este servicio/repositorio.
Descripción de la aplicación: // Opcional