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
  • ¿Qué es Git?
  • ¿Qué son las ramas en Git?
  • Pull request
  • Comandos git
  • Software para Git

Was this helpful?

  1. 2. Explicación de Conceptos

2.8 Git

Previous2.7 Programación asíncronaNext2.9 ¿Qué es Scrum?

Last updated 2 years ago

Was this helpful?

¿Qué es Git?

Git es un sistema de control de versiones, es decir es un sistema que te permite controlar los cambios que haces a tu código, te facilita saber que cambios se hicieron al código, quien realizó el cambio. Se suele tener una copia del código (rama o branch) por cada versión que tienes de tu sistema, así puedes agregar correcciones a tu sistema, mientras continuas trabajando en las nuevas funciones.

Git trabaja de forma local, por lo cual puedes tener versiones de tu código de forma local, las cuales después puedes sincronizar con algún repositorio remoto como Github, BitBucket o Azure Devops.

¿Qué son las ramas en Git?

Por lo general se tiene el código dividido en ramas para que todos los programadores cuenten con el código del proyecto y poder controlar los cambios que cada persona realiza, y poder regresar a una versión anterior o que sea más fácil de revisar que es lo que cambio el código entre una versión y otra del sistema.

Por lo general una forma de trabajar en equipos grandes de desarrollo es mediante ramas (Branches), que te permite crear copias de tu código para tener por ejemplo el código tal cual como esta en producción el sistema (master), y otra copia (rama) que se suele llamar develop (desarrollo) donde se tienen los cambios que los programadores están realizando, también se suele tener una rama con cada versión liberada. Así si vendes tu producto y cobras por versiones del mismo y ocurre un error en alguna versión puedes solo corregir ese error sin pasar todos los cambios de tus nuevas versiones.

También se cuenta con una rama desarrollo, donde cada programador descarga una copia de la rama de desarrollo hace sus cambios y luego crea un pull request que es una petición para informar a los demás programadores o a tu jefe, con los archivos que se cambiaron. Por lo general otro programador o líder revisa los cambios y los aprueba (Approve) o te sugiere mejoras a tu código antes de agregar tus cambios a la rama de desarrollo.

Se tienen varios comandos para comparar el código entre las 2 ramas y actualizar el código de una rama a otra.

Si 2 personas realizan un cambio sobre el mismo archivo git te detecta el cambio y te pide que hagas un Merge que básicamente debes elegir si los 2 programadores cambiaron el mismo archivo cual código es el que se debería quedar.

Pull request

Una vez que terminas tus cambios el siguiente paso es crear un Pull Request el cual contiene los cambios de tu código.

Mejores prácticas para tus Pull Request

Algunas de las mejores prácticas para que tus Pull Request sean mas fáciles de revisar

  • Que sean cambios pequeños, por ejemplo menos de 200 líneas de código.

  • Revisa los PR lo más rápido posible para que la persona que realizo el PR no tenga que cambiarse a otra actividad y luego regresar si es que se sugieren cambios.

  • Puedes mandar recordatorios si tu PR por ejemplo lleva 2 días sin revisión

  • Incluir el resultado de los test o del build en el PR,

  • Configura tu IDE para aplicar un autoformato del código para que todos sigan la misma estructura del formato.

  • Escribir una buena descripción del PR, puedes utilizar templates para facilitar la descripción y checklists

Comandos git

Git cuenta con varios comandos para crear y ver las ramas y subir tus cambios.Algunos de los mas utilizados son los siguientes:

git clone <url>

Permite copiar el código de un repositorio url: dirección del repositorio que deseas clonar.

git branch

Permite ver la lista de ramas. La rama con * es la rama actual.

git branch <nombre>

Permite crear una nueva rama a partir de la rama actual.

git checkout <nombre>

Permite cambiarte a la rama, solo debes indicar el nombre de la rama a la cual quieres cambiarte.

git add .

Agrega todos los archivos que han sido cambiados, para luego confirmar los cambios con git commit.

git add <archivo>

Agrega el archivo que le pases como parámetros

git commit -m "mensaje"

Agrega todos los archivos con un mensaje, por lo general el mensaje es una descripción del cambio que se realiza

git push origin <nombre>

Agrega tus cambios a la rama con el nombre pasado como parámetro en el servidor remoto.

git fetch origin

Descarga la lista de cambios que tiene el servidor remoto que aún no están en tu repositorio local

git pull origin <nombre>

Descarga los cambios del repositorio remoto a tu repositorio local

Software para Git

Si deseas que tu código este público en internet, una buena alternativa es GitHub el cual es gratuito para repositorios públicos y privados ilimitados.

Si trabajas en equipo puedes configurar el proyecto para que esté integrado con Azure Dev Ops:

  • Te facilita llevar el control de código de fuente para un máximo de 5 programadores de forma privada (solo tú y los 4 programadores tienen acceso al código fuente)

  • Te ayuda a llevar una metodología Agile, Scrum o CMMI, incluye Kanboards para llevar un control de las tareas que tienes pendientes

  • Compila tu código y corre las pruebas unitarias

  • Publica los servicios REST por ejemplo en Azure de forma automática.

Esta bastante integrado con Visual Studio Community

Puedes consultar un artículo mas completo aquí:

Para poder utilizar Git en Windows puedes descargar e instalar Git for Windows

También puedes definir una estructura para los mensajes que se van a agregar en cada commit, por ejemplo puedes seguir los convetional commit.

También puedes seguir estas recomendaciones

https://refactoring.fm/p/code-reviews?utm_source=substack&utm_campaign=post_embed&utm_medium=email&s=r
https://gitforwindows.org
https://www.conventionalcommits.org/en/v1.0.0/#summary
https://github.blog/2022-06-30-write-better-commits-build-better-projects/
https://refactoring.fm/p/code-reviews
Diagrama de Código en git con diferentes ramas (branches)