ASP.NET Core Activer le suport de Docker qu'est ce que cela change ?

Vous êtes en train de créer une application ASP.NET Core et vous voyez la case à cocher "Activer le support de Docker" au moment de configurer le Template de votre application (le squelette que va créer Visual Studio pour vous) alors qu'est ce que cela implique ?


ASP.NET Core Activation du support pour Docker

Documentation Microsoft & Docker en ligne

On trouve les liens directement dans la dialogue box de configuration. Pour pouvoir utiliser le support de Docker il faut "Docker pour Windows" c'est à dire :

Install Docker for Windows

System Requirements

• Windows 10 64bit: Pro, Enterprise or Education (1607 Anniversary Update, Build 14393 or later).
• Virtualization is enabled in BIOS. Typically, virtualization is enabled by default. This is different from having Hyper-V enabled. For more detail see Virtualization must be enabled in Troubleshooting.
• CPU SLAT-capable feature.
• At least 4GB of RAM.

Il faut certainement également déjà lire :

Get started with Docker for Windows



Les Containers et les Machines Virtuelles

Sur ce schéma, on voit bien où intervient Docker et le rôle qu'il joue dans la virtualisation des ressources qui permettent à votre application de s'exécuter.

Comparaison des solutions générées par Visual Studio

Je vais simplement comparer les deux solutions générées par Visual Studio, l'une sans la case cochée "Activer le support de Docker" et l'autre avec l'activation du support de Docker.


ASP.NET Core - Support de Docker

.dockerignore

Il existe à gauche un fichier .dockerignore qui ressemble fort au fichier .gitignore que l'on connait avec le gestionnaires de sources "Git". C'est de la gestion de fichiers, simplement indiquer à Docker quels fichiers ne sont pas à prendre en compte.



ASP.NET Core Activer Docker .dockerignore

Les extension de fichiers à ignorer sont donc les suivantes
.env, .git, .gitignore, .vs, .vscode, */bin, */obj, **/.toolstarget


ASP.NET Core Activer Docker - Solution

launchSettings.json

ASP.NET Core Activer Docker - launchSettings.json

Comparaison des fichiers de la solution ASP.NET Core avec et sans activation du Container Docker.

WebApplication1.csproj

C'est le fichier projet de la solution.


ASP.NET Core Activer Docker - WebApplication1.csproj

Le tag "DockerTargetOS" indique que l'on a fait le choix de Windows au moment de la création de la Solution, on aurait pu choisir Linux.

On voit également que Docker utilise le package : Microsoft.VisualStudio.Azure.Containers.Tools.Targets

Dockerfile

N'existe que pour la solution avec support de Docker. On dirait des commandes DOS, c'est l'équivalent d'un lien de lancement de l'exécutable qui sera généré : WebApplication1.dll


ASP.NET Core Activer Docker - Dockerfile

Conclusion sur la comparaison des solutions générées

Il y a vraiment peu de choses dans le code source pour qu'une application ASP.NET Core soit activable pour le support de Docker.

Il reste maintenant à passer à l'installation de Docker pour Windows et là moi je ne peux pas encore vous aider car je suis actuellement encore avec Windows 7 ;-)

Let's have fun!

Comment est utilisé le Design Pattern Pipeline dans ASP.NET Core ?

Nous avons appris que pour ASP.NET Core vs ASP.NET Framework, le fichier Global.asax a disparu. Il est remplacé au profit du pattern Pipeline fournit par OWIN. Alors c'est quoi le Pattern Pipeline et comment est-il utilisé dans ASP.NET Core pour remplacer le fichier Global.asax.

Je vais essayer de répondre et d'abord en effet l'utilisation du fichier Global.asax couple l'application au serveur sur lequel elle est déployée. Autrement dit c'est alors compliqué de faire du multiplateforme comme on souhaite le faire ASP.NET Core.

La difficulté de l'exercice ici, c'est bien de reconnaitre à la fois le design Pattern Pipeline dans les design patterns reconnus et décris. Et en plus de le reconnaitre dans le code de l'application ASP.NET Core qu'il est donnée d'étudier.

Design Pattern Pipeline dans le code C#

Le Design Pattern Pipeline est évoqué ici :

Remplacement du fichier Global.asax

Le Pipeline est fournit par OWIN dans la fonction Startup au démarrage de l'application :

Démarrage d’une application dans ASP.NET Core

Dans la méthode Configure le pipeline de requêtes HTTP est configué en ajoutant des composants d'intergiciel (middleware) à une instance de l'interface IApplicationBuilder.

Ca calme légèrement nos ardeurs ! Au niveau de notre application ASP.NET Core, on est dans le fichier startup.cs, on peut voir l'interface IApplicationBuilder :


Design Pattern Pipeline au sein d'une application ASP.NET Core

Voilà donc l'endroit où l'on peut trouver le Design Pattern Pipeline d'OWIN, utilisé au démarrage de l'application par ASP.NET Core.



Créer un pipeline de middleware avec IApplicationBuilder

Design Pattern Pipeline, est-ce la Chaine de Responsabilités ?

Au début il y a la définition : Wikipedia - Pipeline (software)
In software engineering, a pipeline consists of a chain of processing elements (processes, threads, coroutines, functions, etc.), arranged so that the output of each element is the input of the next; the name is by analogy to a physical pipeline.

Le problème c'est que je ne trouve pas ce Design Pattern dans la documentation classique :

DoFactory - .NET Design Patterns

Il y a bien un pattern qui s'en approche ? Et encore :

DoFactory - Chain of Responsibility
Définition : Avoid coupling the sender of a request to its receiver by giving more than one object a chance to handle the request. Chain the receiving objects and pass the request along the chain until an object handles it.



Design Pattern - Chain of Responsabilities

Pour éviter les couplages cela semble en effet un but du pattern. Et là je ne sais pas dire si ces deux patterns sont bien les même ...

Ici on se pose encore la question :

StackoverFlow :  Would this be a pipeline, a chain of responsibility, or something else?

Là le Hojjet enfonce le clou :

Hojjat Khodabakhsh - CHAIN OF RESPONSIBILITY (PIPELINE) DESIGN PATTERN



Le fameux Design Pattern - Pïpeline

Bon, ça y ressemble assez bien quand même.

Je vous avais dit que cela n'était pas si simple, il me faut continuer cette étude.

To Be Continued, en attendant je vous propose :

Merci de faire un don.

Have fun!

Comment utiliser JQuery.UI with ASP.NET Core 2.0 ?

Vous cherchez une réponse à cette question toute simple dont on a déjà trouvé la réponse avec ASP.NET et vous allez découvrir npm encore un petit jeux avec les packages, y'en a pas un peu marre de tous ces systèmes de gestion de packages ?

Donc c'est étonnant mais la seule non réponse à cette question se trouve là :

https://stackoverflow.com/questions/48457567/how-to-add-jquery-ui-to-asp-net-core-vs2017

C'est une non réponse car une partie de la solution est donnée pour ASP.NET Core 2.1 ... et cette solution parle d'ajouter l'utilisation de LibMan avec ASP.NET Core ce qui nous éloigne encore plus du sujet.



Use LibMan with ASP.NET Core in Visual Studio

En cliquant sur le bouton Upload ...

Il y en a qui se complique la vie

View or download sample code (how to download)
En cliquant sur le lien (how to download) on télécharge un zip.

Dézippe :
\\Visual Studio\Samples\ASP.NET Core\AspNetCore.Docs-master\AspNetCore.Docs-master\aspnetcore\client-side\libman\samples\LibManSample

Il y a un fichier projet :
LibManSample.csproj

Que j'ouvre avec mon Visual Studio 2017 Community :


Use LibMan with ASP.NET Core in Visual Studio

Un petit coup de build ...

Use LibMan with ASP.NET Core in Visual Studio - MSB4018

Et BOUM !

Ah oui avec ASP.NET Core les Nuget sont "par user" dans le répertoire des Users :

ASP.NET Core in Visual Studio - Nuget Packages

Ah mince, ça ne fonctionnera jamais ... en plus imaginez un peu j'ai changé de version de Visual Studio je vois ici d'anciens packages concernant Xamarins ...

Not fun ;-(

J'essaye de renommer le répertoire "package" en "package OLD" évidemment Windows me dit que ce n'est pas possible. Je quitte  donc Visual Studio, je renomme, je rebuild :

Use LibMan with ASP.NET Core in Visual Studio - Packages

Et REBOUM !!

Arg !!! Au secours même erreur MSB4018

A priori, il se plante dans la tâche de construction de build de la librairie Microsoft.Web.LibraryManager.Build.

Erreur MSB4018 Échec inattendu de la tâche "Microsoft.Web.LibraryManager.Build.RestoreTask".

Bon mon propos n'est pas de builder LibraryManager mais c'était d'utiliser JQuery avec ASP.NET Core, l'objectif n'est pas atteint mais on va voir que c'est de plus en plus difficile de travailler avec ASP.NET car les Frameworks se multiplient à gauche à droite.

De qui Angular JS, Angular 2, 3, 4, 5, 6 oui oui si si on en est à 6 ...

React, bref ... on va essayer de faire un peu de ménage dans tout ça.

ASP.NET Core 2.0 c'est quoi ?

Et bien c'est bien plus clean qu'avant, bien plus clean qu'ASP.NET Core 1.0. Est ce que l'on arrive enfin à un réel environnement de développement multiplateforme ? Nous allons voir que le chemin est encore long comme le disait le petit padaoine.

ASP.NET Core dans l'Azure

Je ne vais pas aller très loin. J'ai fais simplement les mises à jour de mon Visual Studio 2017 Community et me voilà avec mes nouveaux templates pour travailler avec ASP.NET Core :



Visual Studio 2017 Community ASP.NET Core Templates

On peut dire une chose déjà, c'est plus simple, je cherche alors de la littérature sur le sujet :

Présentation d'ASP.NET Core

Didacticiels ASP.NET Core

Voilà, c'est ce que j'ai trouvé de mieux. Par la suite, je vais m'intéresser à la structure d'un projet ASP.NET Core 2.0 et à la gestion des packages NuGet, là c'est une autre histoire que j'ai développée Page Suivante.

Voilà la structure de mon projet ASP.NET Core 2.0 :




ASP.NET Core 2.0 Structure

J'ai installé le NuGet JQuery.UI.Combined. On voit que la structure de ce projet est de celle décrite en Janvier 2017 par Jonathan ABRAHAM de Supinfo Ici.

On peut dire qu'avec ASP.NET Core tout va très vite ... ;)

Personnellement je plaints ceux qui se sont lancés trop tôt car avant de montrer une application qui fonctionne à leur client ils ont du batailler.

En effet le  temps que je revienne continuer cet article on est passé au .NET Core 2.1. Les différences notables sont importantes.

Gestion des packages NuGets

On l'a vu, ils ont disparu de la proximité de l'application, il n'y a plus de répertoire App_Data et c'est bien dommage ! Ils sont transférés au niveau du User dans le répertoire suivant :

C:\\Users\UserName\.nuget\packages

C'est stupéfiant, on pense alors au déploiement des applications, maintenant on est plutôt dans une philosophie user : les mêmes NuGets pour toute les applications.

Astuce : Si vous développez plusieurs application sur la même machine de développement. Comme la restauration de NuGets est scripté dans le prébuild de l'application, vous pouvez très bien vous rendre dans le répertoire ".nuget" et renommer le répertoire "packages" en "old packages" par exemple et vous allez voir les nouveaux Nugets pour votre nouvelle application.

Connexion string

On a vu l'utilisation des commandes dans la Console du Gestionnaire de package pour utiliser un le répertoire "Migrations" et générer automatique la Base de données correspondante à l'application.

Là encore en tapant la commande "upate-database" qu'elle ne fut pas ma surprise de constater que la BD ainsi créé se trouve dans :

C:\\Users\UserName\WebApp1.mdf

C'est pas joli joli, en tous je me demande comment on déploie. Les fichiers XML ont été abandonnés au profit de fichiers .json c'est ainsi que la "connection string" se retrouve dans le fichier :

\\Samples\ASP.NET Core\Sample-2.1\appsettings.json



ASP.NET Core - Connection String

 "WebApp1ContextConnection": "Server=(localdb)\\mssqllocaldb;Database=WebApp1;Trusted_Connection=True;MultipleActiveResultSets=true"

Voilà c'est tout pour l'instant ! Mais je reviendrai surement.

IIS Express - Configuration - Ou comment configurer ce Serveur Internet ?

Voici les éléments essentiels de la configuration du serveur Internet "IIS Express", ce que j'ai mis pas mal de temps à trouver car maintenant sur Internet la mauvaise information cache souvent la meilleure. Ben oui, il n'y a plus de modérateur alors ... Heureusement ici que l'essentiel.

Je ne pensais même pas qu'il faillait configurer IIS Expres cette version de développement d'IIS jusqu'à ce que je tombe sur un projet qui s'en servait et qui avait eu du mal à passer de http à https. Vous pourrez lire la littérature sur IIS vs IIS Express bref il ne faudrait pas l'utiliser mais sur ce projet, on se servait d'IIS pour déployer en prod, par conséquent IIS Express était utilisé et dédié au dev.

Ce foutu IIS Express s'installe dans le "systray" de votre ordi, vous savez tout en bas à droite, à côté de l'heure dans la barre des tâches et c'est le SEUL MOYEN d'accès :

Il faut cliquer droit sur l'icône dans le systray :

IIS Express

Pour afficher toutes les applications :

Systray d'IIS Express pour afficher toutes les application

Voici la fenêtre ISS Express qui apparait :

Fenêtre IIS Express de gestion des Sites Web

Configuration d'IIS Express

C'est là que c'est fort car nous n'avons toujours pas accès à la configuration d'IIS Express pour l'instant, il faut encore faire un clique c'est là que tout apparait :

Accès au fichier de configuration d'IIS Express

Donc, j'ai eu du mal à obtenir cette information essentielle pour la configuration d'IIS Express, le fichier de configuration s'appelle le applicationhost.config.

Un partie de la configuration se trouve également dans le .csproj du site web :



Je ne suis pas certain que l'on puisse configurer tout ça à l'aide des Propriétés du projet ...

Utiliser IIS Express au sein du projet de Site Web

Où est par exemple l'option "UseClassicPipelineMode" ? Il me semble qu'on ne la trouve pas dans la page des Propriétés du projet.

Pour rendre à César ... voici de plus amples explications, en anglais, Ici.