Servicios REST con .NET Core
  • Servicios REST con ASP.NET Core y Entity Framework Core
  • 1. Introducción
    • 1.1 Instalación Visual Studio Community
    • 1.2 Instalación de SQL Server en Mac
    • 1.3 Extensión Intellicode
    • 1.4 Aplicación de ejemplo
  • 2. Explicación de Conceptos
    • 2.1 Servicios REST
      • 2.1.1 OData
      • 2.1.2 GraphQL
    • 2.2 Entity Framework para versiones de tu base de datos
    • 2.3 Paquetes Nuget
    • 2.4 Archivo de recursos
    • 2.5 Estructura de los Proyectos .Net Core
    • 2.6 Código Limpio
    • 2.7 Programación asíncrona
    • 2.8 Git
    • 2.9 ¿Qué es Scrum?
      • 2.9.1 Personas
      • 2.9.2 Roles Scrum
      • 2.9.3 Backlog
      • 2.9.4 Reuniones del Scrum
  • 3. Control de código fuente y Scrum con Azure DevOps
    • 3.1 Introducción a Azure DevOps
      • 3.1.1 Crear un nuevo Proyecto en Azure DevOps
      • 3.1.2 Agregando personas al equipo de trabajo
      • 3.1.3 Agregando los sprints y la capacidad de trabajo
      • 3.1.4 Crear el Backlog y asignar User Stories al Sprint
      • 3.1.5 Crear Prototipos
      • 3.1.6 Conectar a Azure DevOps desde Visual Studio
        • 3.1.6.1 Crear tu proyecto con Visual Studio Community y sincronizarlo a Azure DevOps
      • 3.1.7 Consultar tus tareas pendientes
        • 3.1.7.1 Tareas y Dashboards con Azure DevOps
        • 3.1.7.2 Consultar tus tareas desde Visual Studio Community
      • 3.1.8 Trabajando con Ramas (Branches)
        • 3.1.8.1 Crear la rama desarrollo desde Azure DevOps
          • 3.1.8.1 Crear una rama(branch) desde tu tarea en Azure DevOps
        • 3.1.8.2 Como trabajar con ramas (branches) desde Visual Studio Community
        • 3.1.8.3 Crear el Pull Request con Azure DevOps
      • 3.1.9 Retrospectiva del Sprint
      • 3.1.10 Agregando una Wiki
    • 3.2 Integrando tu código fuente a GitHub
      • 3.2.1 Trabajando con ramas en GitHub
      • 3.2.2 Sincronizar los cambios del código con GitHub y Visual Studio
      • 3.3 Trabajando con Branches (Ramas) con Visual Studio
        • 3.3.1 Branches con Visual Studio
        • 3.3.2 Creando un template para tus PR (Pull Request)
        • 3.3.3 Protegiendo tu branch
  • 4. Creando tu primer servicio
    • 4.1 Crear las base de datos y los usuarios en MySQL
    • 4.2 Crear la tabla Categoría y sus validaciones
    • 4.3 Creando el servicio Categorias
    • 4.4 Probando tus servicios con POSTMAN
    • 4.5 Documentar y Probar tus servicios con Swagger
      • 4.5.1 Configurar Swagger
      • 4.5.2 Comentarios XML
      • 4.5.3 Generando la página de documentación
    • 4.6 Agregando índices
    • 4.7 Mejorando tu código
      • 4.7.1 Creando Objetos de Accesos a Datos
      • 4.7.2 Creando tus mensajes de error en diferentes idiomas
      • 4.7.3 Cambiando el formato del Json de los servicios
  • 5. Agregando el servicio para los productos
    • 5.1 Crear la tabla de Productos
    • 5.2 Formas de cargar información de tablas relacionadas
    • 5.3 Crear llaves fóraneas e índices
    • 5.4 Creando el servicio Productos
    • 5.5 Validar Reglas Mejorando tu código
      • 5.5.1 Agregando una excepción a todos nuestros servicios
      • 5.5.2 Agregando clases genéricas para validar y/o consultar información
      • 5.5.3 Alternativa para validar reglas con ef core
  • 6. Cambiar de base de datos a SQL Server
    • 6.1 Cambiar la base de datos a SQL Server
    • 6.2 Cambiar a SQL Server en Azure
  • 7. Crear servicios con OData
    • 7.1.1 Creando el modelo Clientes
    • 7.1.2 Creando el modelo ClienteCategoría
    • 7.1.3 Agregando paquete Nuget para OData
    • 7.1.4 Configurar el EDM Model
    • 7.1.5 Configurar el servicio OData y llaves foráneas
    • 7.1.6 Creando el Controller para clientes
    • 7.1.7 Configurar y probar los servicios con OData
    • 7.1.8 Práctica Crear el servicio para ClientesCategorias
    • 7.1.9 Recomendaciones de seguridad y rendimiento a tomar en cuenta con OData
  • 8. GraphQL
    • 8.1.1 Creando la tabla Caducidad
    • 8.1.2 Creando el query
    • 8.1.3 Configurando y probando graphQL
    • 8.1.4 Creando la Mutation
    • 8.1.5 Probando nuestros servicios con Postman
  • 9. Seguridad
    • 9.1 Json Web Tokens
    • 9.2 Seguridad basada en roles y usuarios
      • 9.2.1 Creando nuestra tabla roles e insertando los roles principales
      • 9.2.2 Consideraciones de seguridad para almacenar tus passwords
      • 9.2.3 Creando las tablas para manejar la seguridad
      • 9.2.4 Agregando usuarios y roles
    • 9.3 Agregando seguridad a nuestros servicios
    • 9.4 Creando nuestro servicio de login y generar el token
    • 9.5 ¿Cómo agregar seguridad basada en roles a los Servicios REST?
      • 9.5.1 Seguridad basada en claims
      • 9.5.2 Creando las tablas para validar permisos por cada tabla
      • 9.5.3 Seguridad basada en directivas
      • 9.5.4 Seguridad con Action Filters
    • 9.6 Guardando el historial de cambios
    • 9.7 Refrescando tu token
    • 9.8 Seguridad Mejorando tu código
      • 9.8.1 ¿Cómo limitar el número de intentos incorrectos en el login?
      • 9.8.2 ¿Cómo obtener la ciudad del usuario por medio de la IP?
      • 9.8.3 Habilitando CORS
  • 10. Pruebas Unitarias
    • 10.1 Agregando el proyecto de pruebas unitarias
    • 10.2 Crear una prueba unitaria
      • 10.2.1 Ejecutando las pruebas unitarias
    • 10.3 Agregando una base de datos en memoria para nuestras pruebas unitarias
    • 10.4 Agregando la referencia de nuestro proyecto CaducaRest
      • 10.4.1 Agregando paquetes nuget necesarios
    • 10.5 Configurando Clases para Objetos Sustitutos
      • 10.5.1 Configurando el Contexto para utilizar la base de datos en Memoria
      • 10.5.2 Configurando el objeto para sustituir mensajes de Error por idioma
    • 10.6 Agregando pruebas para las Categorías
  • 11. Integración continua
    • 11.1 ¿Qué es la integración continua?
    • 11.2 Subir tu código fuente a BitBucket
      • 11.2.1 Integración continua y pruebas automáticas con Bitbucket
    • 11.3 Integración continua y pruebas automáticas en Azure DevOps
  • 12. Pruebas de integración
    • 12.1 ¿Qué es SpecFlow?
    • 12.2 Agregando el proyecto de pruebas de integración
    • 12.3 Configurando Specflow
    • 12.4 Creando pruebas para el login
    • 12.5 Agregando las pruebas de Integración a Azure Devops
    • 12.6 Specflow Mejorando tu código
      • 12.6.1 Cambiando las pruebas a español
      • 12.6.2 Pasando tablas a nuestras pruebas
      • 12.6.3 Agregar los passwords como variables de ambiente
      • 12.6.4 Probando con SQLite
      • 12.6.5 Agregando diferentes parámetros con MSTest
      • 12.6.6 Generando el reporte living doc de specflow
  • 13. Integración continua con Postman
    • 13.1 Recomendaciones para probar tus servicios
    • 13.2 Instrucciones básicas para probar con Postman
    • 13.3 Crear colecciones en Postman
    • 13.4 Agregar pruebas a tus servicios
    • 13.5 Crear environments
    • 13.6 Agregando datos de prueba con archivos .csv
    • 13.7 Exportando tus colecciones y ejecutarlas con Newman.
    • 13.8 Agregando las colecciones de postman al pipeline
  • 14. Pruebas de usuario
    • 14.1 Page Object Model
    • 14.2 ¿Qué es Selenium?
      • 14.2.1 Selenium Instrucciones básicas
      • 14.2.2 Agregando el proyecto de pruebas de usuario
    • 14.3 ¿Qué es Cypress?
      • 14.3.1 Cypress Instrucciones básicas
    • 14.4 ¿Qué es Playwright?
      • 14.4.1 Playwright Instrucciones básicas
  • 15. Despliegue Continuo con Azure DevOps y Azure
    • 15.1 Crear un App Service en Azure
    • 15.2 Generando Artifacts en Azure Pipelines
    • 15.3 Generando el Release en Azure Pipelines al App Service de Azure
    • 15.4 Ejecutando las colecciones de Postman después del release
    • 15.5 Agregando las pruebas de usuario en Azure Pipelines
  • 16. Instalación en Windows Server e IIS
    • 16.1 Instalar IIS en Windows Server
    • 16.2 Instalación del ASP.NET Core Module/Hosting Bundle
    • 16.3 Crea el Sitio Web en IIS
  • 17. Instalación en Linux
    • 17.1 Creando una máquina virtual linux en Azure
    • 17.2 Habilitando el acceso remoto
    • 17.3 Configura linux para .Net Core
    • 17.4 Instalando mysql
    • 17.5 Instalando Nginx y configurando tu servicio
    • 17.6 Instalando un certificado SSL gratuito con CertBot
    • 17.7 Agregando diferentes subdominios
  • 18. Docker
Powered by GitBook
On this page
  • Actualiza automáticamente tu base de datos.
  • Actualiza tu App Service de Linux.
  • Actualiza automáticamente después del commit.
  • Actualiza en una fecha y hora.
  • Actualiza de forma manual.
  • Agrega condiciones antes o después de cada paso.

Was this helpful?

  1. 15. Despliegue Continuo con Azure DevOps y Azure

15.3 Generando el Release en Azure Pipelines al App Service de Azure

Previous15.2 Generando Artifacts en Azure PipelinesNext15.4 Ejecutando las colecciones de Postman después del release

Last updated 2 years ago

Was this helpful?

Una vez que generamos los artifacts vamos a crear nuestro release, en este ejemplo creare un release automático, en el cual después del commit se instalará automáticamente en el AppService creado en la sección 12.1 Crear un App Service en Azure.

  1. Entra a Azure DevOps, selecciona la opción Pipelines, luego Releases.

  2. Da clic en el botón New Pipeline

3. Del lado izquierdo se muestran los pasos de tu release, y del lado derecho se muestran sugerencias para crear tu release, elige la opción Azure App Service deployment y da clic en Apply.

4. En Stage name escribe un nombre descriptivo, en este ejemplo será Deploy to Azure y selecciona quien es el dueño de este paso, selecciona al usuario encargado del deploy. Da clic en el botón cerrar(X).

Si todo es correcto queda de la siguiente manera:

4. Da clic en Add an artifact para seleccionar nuestros artifacts.

5. Selecciona lo siguiente:

  • Source Type: Selecciona Build para utilizar los artifacts creado en el pipeline.

  • Project: Selecciona tu proyecto de Azure Devops en este caso es CaducaRest

  • Source (build pipeline): Selecciona tu pipeline. En mi caso se llama apis3445.CaducaRest

  • Default version: Selecciona Latest para seleccionar la última versión generada.

  • Source alias: Agrega un nombre para identificar el release, en mi caso será desarrollo.

6. Da clic en el link 1 job, 1 task para configurar el deploy.

Debido a que de momento Azure Pipelines no soporta correctamente la versión de .Net Core 3.1 voy a borrar el task generado por default para agregar otro que permite mas configuración.

7. Selecciona el task Deploy Azure App Service y da clic en el botón Remove.

Actualiza automáticamente tu base de datos.

Actualizando tu base de datos de MySQL en un hosting o servidor.

Si tienes tu base de datos en un servidor propio o en un hosting puedes utilizar la tarea MySQL database deploy.

Primero voy a agregar variables de tipo secret con los datos para conectarme a la base de datos de MySQL.

  1. Selecciona el tab Variables y da clic en el botón + Add.

Agrega una variable para configurar la conexión a la base de datos. Da clic en el candado para mantenerlas secret. Un ejemplo del nombre de las variables puede ser el siguiente:

  • MySQLS: Contiene el nombre del servidor de la base de datos.

  • MySQLD: Contiene el nombre de la base de datos.

  • MySQLP: Contiene el password del usuario con acceso a modificar la base de datos.

  • MySQLU: Contiene el usuario con acceso a modificar la base de datos.

2. Regresa al tab Tasks, da clic en el botón + Agrega la tarea MySQL database deploy y da clic en Add.

Agrega los siguientes valores:

  • Display name: El nombre que se verá en tu task, en este caso será Actualizar BD.

  • Deploy MySQL using: Puedes seleccionar si deseas actualizar tu base de datos con un archivo script o tecleando directamente las sentencias para actualizar tu base de datos. Elige la opción MySQL Script File ya que ya tenemos generado el archivo.

  • MySQL Script: Selecciona el archivo que creaste en el pipeline. En este caso es: $(System.DefaultWorkingDirectory)/_apis3445.CaducaRest/Scripts/update_to_latest.sql

  • Host Name: Agrega la variable del servidor en mi caso es $(MySQLS).

  • Database Name: Agrega la variable con el nombre de la base de datos. $(MySQLD).

  • Mysql User Name: Agrega la variable con el nombre del usuario de la base de datos: $(MySQLU).

  • Password: Agrega la variable con el password: $(MySQLP).

Actualiza tu App Service de Linux.

Por último debes agregar un task para subir tu aplicación al App Service de Linux.

  1. Da clic en el botón + para agregar una tarea Azure Web App.

2. Configura la tarea de la siguiente manera:

  • Diplay name: Es el nombre del paso en este caso es: Azure Web App Deploy: restcaduca.

  • Azure subscription: Selecciona la suscripción de Azure en donde creaste tu AppService y da clic en Authorize.

  • App type: Selecciona tu tipo de app, en mi caso como mi app service es linux, seleccionaré Web App on Linux.

  • App name: Selecciona el nombre de tu app en mi caso es restcaduca.

  • Package or folder: Selecciona el artifacto creado para linux: $(System.DefaultWorkingDirectory)/_apis3445.CaducaRest/restLinux/CaducaRest.zip

  • Runtime stack: Selecciona el runtime 3.1 (DOTNETCORE|3.1).

Da clic en Save y listo.

Actualiza automáticamente después del commit.

Para configurar que se ejecute automáticamente el release da clic en el símbolo de un rayo y selecciona la opción Enabled.

Actualiza en una fecha y hora.

También puedes programar el release para una fecha y hora en especial si das clic en la opción Schedule not set.

Selecciona la opción Enabled y por default te sugiere que se actualice de Lunes a Viernes a las 3:00 am.

Actualiza de forma manual.

Una vez configurado, cada vez que hagas un cambio al código se ejecuta el release, si deseas ejecutar un release de forma manual da clic en Create release.

Puedes configurar lo siguiente:

  • Stages: Puedes seleccionar uno de los pasos o todos los pasos que has configurado. En mi caso ya tengo el release con 2 pasos uno para el deploy y otro para testing.

  • Artifacts: Puedes seleccionar la versión de tu sistema que deseas instalar.

  • Release description: Agrega una descripción para el release.

Por último da clic en Create y se ejecutaran los pasos.

Puedes seleccionar el release y ver el avance paso a paso.

Al finalizar verás algo similar a lo siguiente:

En caso de ocurrir algún error llega un correo a la cuenta del usuario owner del release, con el detalle del error.

Después de terminar puedes entrar a tu sitio web.

Agrega condiciones antes o después de cada paso.

Azure Dev Ops te permite agregar una variedad de condiciones antes o después de cada Stage algunos ejemplos son:

  • Seleccionar uno o mas miembros del equipo para que aprueben los artifacts antes de hacer el deploy.

  • Solo permitir release por medio de Pull Request y que los Pull Request sean aprobados por uno o mas miembros del equipo.

  • Asegurar que no tengas bugs, defectos o soportes activos o puedes por ejemplo filtrar para que estén terminadas ciertas tareas importantes

  • Puedes agregar tareas (Manual Intervention task) que deben ser completadas manualmente antes del release por ejemplo asegurarse por medio de un correo electrónico que el cliente apruebe la instalación de la nueva versión, o que se haya pagado por la actualización del sistema.

  • Deseas que un usuario manualmente cambie los parámetros o variables del pipeline.

Agregando condiciones para no desplegar si hay bugs que no están cerrados.

Para poder agregar una regla donde antes del release no debe existir ningún bug abierto en el sprint, es necesario primero crear el query con la regla que deseas.

  1. Ve a la opción: Boards -> Queries. Da clic en New query.

2. Agrega los Filtros para filtar los bugs que se encuentran activos en el sprint actual con los siguientes filtros:

  • Work Item Type = Bug

  • And State <> Closed

  • And Iteratipon Path = @CurrentIteration y selecciona tu proyecto

Si le das clic en Run query se ejecutan los filtros y se ven los resultados, en mi caso no tengo ningún bug activo, por lo tanto no se muestran resultados.

3. Da clic en Save query, teclea el nombre por ejemplo Bugs Activos y en el Folder tiene que estar en Shared Queries para que sea utilizada en el release. Da clic en el botón OK.

4. Ve a Pipelines -> Releases en el área de Deploy selecciona tu Release y da clic en Edit.

5. Da clic en Pre-Deployment conditions el cual tiene el símbolo de una persona.

Habilita la opción Gates. Ir a Gates luego Enabled.

Da clic en el botón + Add y selecciona la opción Query work items.

6. Selecciona las siguientes opciones:

  • Query: selecciona la query que acabas de crear Bugs Activos .

  • Upper treshold: Es la cantidad máxima de resultados que debe regresar el query, en este caso es 0 porque no queremos ningún bug activo.

Da clic en Save y agrega algún comentario.

Agregando personas que autoricen el release.

Puedes agregar otra condición para por ejemplo seleccionar al usuario que apruebe o rechace los cambios, esto para el caso de tener un servidor de qa, algunos usuarios puedan revisar y aprobar la versión.

  1. Selecciona Post-Deployment Conditions el icono de un usuario al final del stage de las pruebas.

2. Configura lo siguiente:

  • Post-deplyment: approvals Enabled

  • Timeout: Elije la cantidad máxima de días que tienen para revisar la versión.

  • Approval policies: selecciona esta opción si deseas que la persona que solicita el pull request no debe ser la amisma que la aprueba.

Da clic en Save.

Puedes consultar el siguiente link con la documentación oficial.

Para practicar puedes configurar un nuevo stage para publicar en el app service de windows. El resultado quedaría así:

Puedes ver la documentación oficial para configurar el release en Azure Devops .

aquí
Descripción de valoraciones, comprobaciones y aprobaciones de versión - Azure Pipelinesdocsmsft
Logo