Ejecutando, depurando y desplegando microservicios con “Tye”. De paso, un vistazo a LENS

En este post vamos a ver de una manera simple y directa el uso de Project Tye y cómo desplegar aplicaciones .NET Core / .NET 5 en Kubernetes en general y, en AKS en particular. Gracias a Tye, a partir de ahora, este tipo de despliegues va a ser mucho más sencillo. ¿Te atreves?

Ademas, veremos que es Kubernetes LENS y como este permite la integración con Prometheus en un solo click.

En definitiva, todo lo que necesitamos para ejecutar, depurar, desplegar y gestionar nuestra aplicación en un cluster de Kubernetes, y, por si fuera poco, todo ello en unos unos pocos minutos, 😉

¿Que es Tye?

Tye (o Project Tye), es una herramienta de desarrollo que facilita el desarrollo, los tests y la implementación de microservicios y aplicaciones distribuidas. Incluye un orquestador local para facilitar el desarrollo de microservicios y la capacidad de implementar microservicios en Kubernetes con una configuración mínima y de manera muy sencilla.

Tye no solo permite el despliegue de aplicaciones dotnet, si bien para proyectos .NET (ficheros .csproj), lo facilita MUY ENORMEMENTE. ¡De entrada, te olvidas de los “.dockerfile”, Tye los genera automáticamente por ti!.

Para más detalle, podemos echar un ojo aquí, al repositorio de Github de Tye.

Podríamos decir también que es equivalente a Docker Compose, pero presenta justo las diferencias que lo hacen mucho mas sencillo e indicado especialmente para proyectos .NET Core / Net5. Por ejemplo, los servicios no tienen porque ser únicamente contenedores, pueden ser también “ejecutables” (en este caso con algunas configuraciones para la comunicación) y, por supuesto directamente, proyectos .NET (.csproj).

Si te interesa saber más sobre la comunicación entre ejecutables y/o conteneros, Eduard Tomás (@eiximenis) detalla mucho mucho más este tema en este post.

En la pasada #dotNETConf, vimos la siguiente tabla que resume a modo de Cheat Sheet los comandos de Tye y una comparativa con otras herramientas. Creo que de un vistazo puede aclarar muchas dudas sobre lo que es Tye y hasta dónde puede llegar.

Imagen

Instalar Tye

Esta instalación es sencilla, basta únicamente con utilizar “dotnet tool install -g” tal y como se muestra a continuación, indicando la versión ya que en estos momentos no existe aún una versión release.

dotnet tool install -g Microsoft.Tye --version "0.5.0-*" --add-source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet5/nuget/v3/index.json

Desarrollar/trabajar con un ejemplo

mkdir microservices
cd microservices

dotnet new razor -n frontend
dotnet new webapi -n backend
dotnet new sln
dotnet sln add frontend backend // (*) Añadir código para acceder desde el frontend al backend y uso de Redis Cache
tye init

(*) Puedes añadir manualmente este código o utilizar directamente el que puedes encontrar en este repo de Git.

El comando anterior tye init crea un fichero “tye.yml” tal y como se muestra a continuación:

name: microservices
services:
- name: frontend
  project: frontend/frontend.csproj
  replicas: 1  
- name: backend
  project: backend/backend.csproj
  replicas: 1
- name: redis
  image: redis
  bindings:
  - port: 6379
    connectionString: "${host}:${port}"

Como podremos observar en el código, para la comunicación entre frontend y backend no se especifica la ruta base, ni mucho menos se utiliza hardcode, en su lugar, se especifica el nombre del backend y el Service Discovery de Tye se encarga del resto. Para usarlo, bastará con añadir a nuestro proyecto la referencia al paquete nuget: “Microsoft.Tye.Extensions.Configuration“. ¡Si quieres profundizar sobre ello, visita este link!.

Ejecución en local

Ejecutar tye run desde línea de comandos y navegar a la url del Dasboard de tye tal y se observa en el detalle de ejecución (http://127.0.0.1:8000, para este caso en particular).

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-7.png
La imagen tiene un atributo ALT vacío; su nombre de archivo es image-9.png

Importante: Tanto el puerto del Dashboard como el del resto de servicios/proyectos, cambiará de manera dinámica, por lo que es importante tenerlo en cuenta.

Por detrás, Tye, usa Docker y genera las imágenes y contenedores necesarios para ello. Podemos comprobarlo si ejecutamos desde línea de comandos “docker ps“, tal y como muestra la siguiente salida.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-20.png

Despliegue en AKS

En primer lugar y previo a ejecutar el despliegue, es importante asegurar que:

  • Existe un Cluster de AKS. ¡Para este ejemplo, he utlizado la última versión 1.19.3 (aun en preview).!
  • Realizar el login en el Cluster de AKS y obtener las credeciales para su acceso
az login --tenant <TENANT-ID>
az account set -s <SUBSCRIPTION-ID>
az aks get-credentials --resource-group <RESOURCE_GROUP_NAME> --name <AKS_CLUSTER_NAME>
  • Permitir a AKS el acceso a Azure Container Registry. Para ello, ejecutar la siguiente instrucción una vez que haya sido creado el Cluster de AKS.
az aks update -n <AKS_NAME> -g <RESOURCE_GROUP_NAME> --attach-acr <AZURE_CONTAINER_REGISTRY_NAME>
  • Ejecutar desde línea de comandos: “tye deploy -y” e indicar el Container Registry cuando se requiera. De igual forma, indicar la cadena de conexión de Redis Cache, la cual quedará almacenada como un secreto en AKS.

Acceso a la Información de AKS (“Dashboard”)

Para la visualización, consulta de log y gestión de nuestro Cluster AKS, disponemos de varias herramientas, que revisamos a continuación:

La versión 1.19.3 de AKS ya no permite lanzar el Dasboard desde linea de comando con el CLI “AZ”. Ha quedado deprecado y, en su lugar, es el Portal de Azure quien nos presenta esta información. Eso si, por el momento en modo “Preview”.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-12.png

Por otro lado, y además de “kubectl” (como es de sobra conocida), contamos con la extension para VSCode, “Kubernetes“, tal y como muestra la siguente imagen, y que también, es conocida.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-10.png

Disponemos además, de otra herramienta, que me ha enamorado y que he descubierto recientemente, gracias a “@JGallardoRama”. Se trata de “LENS“, un IDE tanto para Windows como para MAC y Linux, que gestiona diferentes Cluster de Kubernetes (Minikute, AKS, EKS, GKE, etc.) así como la integración con Helm y otros orquestadores. Es más, permite, con un simple click (opción de menú: “File – Cluster Settings – Features (Metrics) – Install), la integración con Prometheus, instalándolo automáticamente en el Cluster de Kubernetes.

LENS: World’s most popular Kubernetes IDE provides a simplified, consistent entry point for developers, testers, integrators, and DevOps, to ship code faster at scale. Lens is the only IDE you’ll ever need to take control of your Kubernetes clusters. It is a standalone application for MacOS, Windows and Linux operating systems. Lens is an open source project and free!

En la siguiente imagen podemos ver una imagen de LENS, y en concreto, la opción de “Overview” del Cluster. Vemos también acceso directo a los Pods, Deployments, etc. y la posibilidad de realizar acciones, como eliminar, editar y escalar. ¡En mi opinión, creo que no tardará en disponer de la realización de todas estas acciones de manera masiva, lo que la hará mucho mas y útil 🙂!

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-14.png

En esta otra, podemos ver la integración con Prometheus.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-15.png

Incluyendo un Ingress

Si añadimos al final del fichero “tye.yaml” el siguiente código, dotaremos a nuestra aplicación/sistema de un ingress.

ingress:
  - name: ingress
    bindings:
      - port: 8080
    rules:
      - path: /
        service: frontend

Si ejecutamos nuevamente “tye deploy -i” y navegamos a la IP externa/publica proporcionada por AKS, comprobamos que nuestra aplicación se ejecuta correctamente, en el puerto 80.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-17.png

Depuración

  • Ejecutar “tye run –debug
  • Atachar el proceso correspondiente al proyecto de frontend o backend desde Visual Studio Code o Visual Studio.
La imagen tiene un atributo ALT vacío; su nombre de archivo es image-18.png

Pero, ¿Qué ocurre al depurar si tenemos 3 réplicas? Tendremos que depurar cada una de ellas de manera independiente, o bien, abrir tantas instancias de Visual Studio Code o Visual Studio como replicas existan.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-19.png

Espero que sea de utilidad y ayude a perder un poco el miedo para crear y probar arquitecturas e infraestructuras basadas en Kubernetes.

Referencias:

Tooling para presentar Charlas/Eventos/Demos

Durante estos días está teniendo lugar la #dotNETConf en la que no solo estamos viento novedades de .NET, también es momento para compartir todo tipo de experiencias. En concreto en este post, quiero hacer mención a dos de las herramientas que usan los Presentadores, y que ademas @shanselman contaba ayer en una de sus charlas.

ZoomIt

ZoomIt es la herramienta de Sysinternals, para anotaciones y zoom de pantalla.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-4.png

La siguiente imagen muestra un rectangulo y una flecha señalando la caja de texto de “Power Toys Run” :

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-6.png

Aunque con 5 min de dedicación es facil entenderla al completo, los paso seguidos son estos para este ejemplo en concreto son los siguientes:

  • Ctrl + 1. Realiza el zoom de la pantalla. ¡Si pulsamos Ctrl + 2 en su lugar evitamos hacer el zoom, si no lo necesitamos!
  • Mouse Left Click. Fijamos el zoom en el punto en el que poner el foco.
  • [Opcional]. En este punto, al pulsar la tecla, r, g, b, y, el color del rectangulo o la flecha cambiará por Red, Gree, Blue o Yellow, respectivamente.
  • Ctrl + Mouse Left Click. Pintamos el rectangulo.
  • Shift + Ctrl + Mouse Left Click. Pintamos la flecha.

Nota: Las combinaciones de teclas indicadas son las predetermindas, si bien, estas pueden ser adecuadas a nuestro antojo.

Azure Mask

Azure Mask (Az Mask). Es una extensión de Chrome / Edge (Chromium) que permite enmascarara (o hacer “blur“) de todas los textos de caracter sensible al navegar a lo largo del Portal de Azure.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image.png
Extesión de Chrome
La imagen tiene un atributo ALT vacío; su nombre de archivo es image-3.png
Habilitar / Deshabilitar el enmascarado

A continuación podemos ver un ejemplo de su uso:

La imagen tiene un atributo ALT vacío; su nombre de archivo es azmask-1.gif

Nota: Como excepción, la parte de la url correspondiente a la subscripción no es ofuscada por la herramienta.

Creo que voy a comenzar a sustituir a “Magnifier” y, por supuesto, a dejar enmascarar manualmente cada pantallazo de Azure que incluyo en mis posts 🙂

Saludos/regards and enjoy #dotNETConf days !

Gran momento en el Podcast: NTN con @elbruno y @jc_quijano

Partiendo de no tener un guión inicial, durante 1h, (que me han parecido minutos), he compartido con @elbruno y @jc_quijano una gran momento. Momento tan cercano y familiar, que hasta me ha llegado a suponer un empujón emocional y motivacional. ¡Pilas cargadas para seguir al pie del cañón tecnológico otros tantos años más!

Hemos hablado de temas como: Blazor, Arquitectura de Software, generación de código, usuarios de Windows que usan Mac (:D), Angular por todos lados (y en especial para un “.NET-tero” como yo), consumición de contenidos online, Microsoft Ignite, NetCoreConf y mucho, mucho más.

Un repaso general y cambios de impresiones, que creo que merece la pena escuchar. ¡Nos faltó la cervecita!

Aquí os dejo el link: https://www.ivoox.com/ntn-66-sobre-exceso-eventos-audios-mp3_rf_57486368_1.html

Un placer estar de este otro lado/canal y espero que lo disfrutéis como yo lo he disfrutado.

Un saludo
Juanlu.

Improving the Code Quality in .Net and .Net Core projects using NDepends

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-7.png

Continuando con el análisis de código, la cobertura y los tests como ya viemos en este post (“Runing Tests and Code Coverage without Visual Studio. OpenCover con coverlet y ReportGenerator“), seguiremos profundizando en el “Code Quality”, y conoceremos otra buena herramienta, también extensión de Visual Studio e integración con Azure DevOps, NDepends:

NDepend es la única extensión de Visual Studio que puede decirnos que durante la última hora, el código recién escrito ha introducido una deuda técnica que costaría, por ejemplo, de 30 minutos. Sabiendo esto, podemos arreglar el código, incluso antes de comprometerlo con el control de código fuente.
Con NDepend, las reglas son consultas C# LINQ que se pueden crear y personalizar en cuestión de segundos. Estas consultas contienen fórmulas de C# para calcular estimaciones técnicas de la deuda.
El conjunto de reglas predeterminado ofrece más de cien reglas de código que detectan una amplia gama de Code Smell que incluyen código espagueti, código muerto, breaking changes, y mal uso de POO.

Antes de nada, quiero aprovechar la oportunidad y dar las gracias a Patrick Smacchia, quien me a invitado a probarla y a sacar mis propias conclusiones, que sin duda, me adelanto a decir que han sido satisfactorias.

Así mismo quiero hacer referencia a este post de Variable Not found, donde @jmaguilar, comentaba las bondades de esta herramienta. Profundizaré comentando nuevas características y mejoras que han seguido llegando. Como podemos ver, directamente al abrir la herramienta nos encontramos ya con nuevas integraciones: AppVeryor, Bamboo, VSCoverage, OpenCover, DotCover, NCover además delas ya conocidas: VSTS, TeamCity, Sonarqube, Jenkins y Reflector:

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-6.png

Par probarla, instalaremos la extensión para Visual Studio y utilizaremos este ejemplo (https://github.com/juanluelguerre/DotNet.ApiRest.BasicTemplate) .

En Visual Studio 2019, tenemos una nueva opción de menú (Extensions – NDepend) con multitud de opciones:

La imagen tiene un atributo ALT vacío; su nombre de archivo es image.png

Para añadir la solución , proyectos y/o ensamblados y así asociar NDepend para su ejecución, ejecutamos “NDepend Project Properties” y a continuación, el análisis (Run Analysis) tras el cual se muestra un Dashboard. Dashboard que representa un resumen general del estado de nuestra aplicación. A partir del mismo podemos acceder a cada uno de sus detalles que iran siendo mostrados en la ventana de la derecha y nos irán facilitando la posibilidad de navegar por el código e incluso ejecutar acciones sobre propio código.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-2.png

Uno de los puntos interesantes es la facilidad para hacer consultas sobre el código o incluso definir nuevas reglas, usando un lenguaje muy similar a “Linq” . Para ello bastará con editar las mismas o bien crear una nueva.

En lo que respecta, por ejemplo, a la deuda técnica, podemos verla detallada por método e incluso acceder y/o modificar el código “Linq” equivalente.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-3.png

Asi mismo, para nuevas personalizaciones tenemos varias alternativas mediante el menu: “Tools – NDepend – new y sub-menu: Code query… | Code Rule… \ Quality Gate… | Tend Metric…\ Trend Chart… \ Rule File… \ Project …“.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-5.png

Donde, para la creación de una nueva consulta (“Tools – NDepend – new – Code Query“), navegamos a la ventana de edición que incluso incorpora Intellisense, lo que nos facilita mucho más el trabajo.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-6.png

En cuanto a la covertura de código, NDepends proporciona el siguiente detalle de manera totalmente gráfica en proporción al número de lineas de código (LOC), e incluso, en la ventana de la derecha, el % de cobertura, a nivel de namespace, clase, método, etc..

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-7.png

La matriz de dependencias no cambia mucho con respecto a la que ya conocíamos,

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-9.png

sin embargo, el gráfico/diagrama de dependencias si que lo hace, con un diseño mucho más moderno y una navegación mucho más amigable e intuitiva y, nuevamente con posibilidad de edición:

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-11.png

Por otro lado, en la esquina inferior derecha de Visual Studio, encontramos también una opción, en la que, además de algunos accesos directos, vemos a modo de resumen datos significativos sobre el estado de nuestro código.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-1.png

Que también cuenta con una opción “Run Analysis and Build Report“, que, además de mostrar el Dashboard, como hemos visto anteriormente, genera un report local (en formato html), totalmente navegable y accesible a todos los detalles. Como podemos imaginar, su consumo, va a permitirnos no depender directamente de Visual Studio.

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-4.png

Por ultimo, NDepend cuenta con una herramienta de línea de comando avanzada (NDepend Power Tools), que hace uso del API de NDepends y proporciona una amplia variedad de características, desde la búsqueda de código duplicado, facilidad para la revisión de código y, hasta la detección de cambios de API públicas:

La imagen tiene un atributo ALT vacío; su nombre de archivo es image-5.png

Como conclusión, y coincidiendo con @jmaguilar, NDepend:

  • No requiere la edición “Enterprise” de Visual Studio y tenemos la posibilidad de usar su versión stand alone.
  • Es una herramienta, en mi opinión muy potentente, que además resulta casi imprescindible en grandes proyectos y de alto y constante mantenimiento.
  • Esencial al adquirir/heredar proyectos de terceros, donde de un primer vistazo vamos a poder tener una amplia visión sobre el estado del mismo. Va a permitirno poder hacer una valoración y saber a que nos enfrentamos desde un primer momento.
  • Añadir, que se trata de una herramienta de pago con su versión trial que puedes descargar aquí.

Espero que sirva de utilidad y que ayude a seguir creciendo como programadores además de a continuar mejorando y aprendiendo de las buenas practicas.

Happy Coding and good Quality !

Referencias:

[Material] Evento Blazor (C# en el Browser)

image

Buenas,

Ayer 28 de Junio he vuelto a poder compartir conocimiento y muy buenos momentos con los compañeros de SVQDotNet, hablando de #Blazor en el evento: BLAZOR: Browser + Razor (C# en el Navegador) ¿Adios a JavaScript?

Dejo aquí el material empleado en la misma:

ver-github

En esta otra entrada puedes continuar profundizando.

Un saludo
Juanlu

[Material] “.Net LOVE Open Source”

imageDurante el día de hoy ha tenido lugar l “I Jornada de conocimiento abierto“, en Huelva.

Ha sido un día interesante en lo que respecta al Software y Hardware libre así como en lo referente al Open Source, donde he tenido la oportunidad de participar, y, como no podía ser de otra manera con esta presentación “.Net LOVE Open Source“, en la que he tratado los siguientes puntos:

  • Free Software VS Open Source
  • Microsoft y el Open Source
  • .NET Open source
  • .NET Core
  • Azure, Dockery más…

A continuación dejo la presentación.

 

Un saludo & happy Open weekend

Juanlu

Nuevas Características C# 7.1

cs71_featuresBuenas,

Siguiendo con las características de C#, en este post continuaremos con nuestro Tour y veremos concretamente las de C# 7.1:

  • Async Main Method
  • Default Literal Expressions
  • Inferred Tuple Element Names

ver-github

¡Recordemos que aquí tenemos los links a todos los post sobre las características de C# desde su versión 6.0: https://elguerre.com/2017/12/14/y-ms-new-features-c-7-0-2-2/!

Enjoy your coding !
Juanlu

Referencia: https://docs.microsoft.com/es-es/dotnet/csharp/whats-new/csharp-7-1

Y más… New features C# 7.0 (2/2)

imageHola,

Una vez más, continuamos conociendo más características de C# 7.0. En esta ocasión, las cinco restantes a las que ya vimos en el post anterior. Las conoceremos a través del siguiente vídeo:

Ver vídeo Youtube

Local Functions
More expression-bodied members
throw Expresions
Generalized async return types
Numeric literal syntax improve-ments

Y como viene siendo habitual, aquí tenemos el código para “cacharrear” todo cuanto queramos sobre estas nuevas características.

Resultado de imagen de github logos resources

Referencias:
Características de C# 6.0 Parte 1
Características de C# 6.0 Parte 2
Características de C# 7.0 Parte 1
– https://docs.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-7

Saludos & happy coding in C#
Juanlu

Continuamos: New features C# 7.0 !

FeaturesCShar7-Parte1

Hola,

Continuamos conociendo características nuevas de C#, concretamente,  las de 7.0 y en profundidad, las cinco primeras de ellas en esta ocasión.

Como en post anteriores las veremos a través de un Video Tip (Video tutorial) que podemos encontrar en mi canal de Youtube: https://www.youtube.com/user/JuanluElguerre .

Imagen relacionada

En este pequeño vídeo mostraremos las siguientes características:

Out Variables
Tuples
Discards
Pattern Matching
ref Locals and Return

Resultado de imagen de github logos resourcesResultado de imagen de github logos resources


Referencias:
– Características de C# 6.0 Parte 1
– Características de C# 6.0 Parte 2
https://docs.microsoft.com/en-us/dotnet/csharp/whats-new/csharp-7

Un saludo and happy improving your coding with C#
Juanlu