Déployer un service Worker sur Azure

Pour créer un projet de Service Worker avec Visual Studio, sélectionnez Fichier>nouveau>projet.... Dans la boîte de dialogue Créer un nouveau projet, recherchez « Worker Service », puis sélectionnez le modèle de Service Worker. Entrez le nom de projet souhaité, sélectionnez un emplacement approprié, puis sélectionnez Suivant. Dans la page Informations supplémentaires , pour l’infrastructure cible , sélectionnez .NET 5.0, puis cochez l’option Activer Docker pour activer la prise en charge de Docker. Sélectionnez le système d’exploitation Docker souhaité.

Pour créer un projet de service Worker avec Visual Studio Code, vous pouvez exécuter des commandes CLI .NET à partir du terminal intégré. Pour plus d’informations, consultez Visual Studio Code : Terminal intégré.

Ouvrez le terminal intégré, puis exécutez la dotnet new commande, puis remplacez le <Project.Name> nom de votre projet souhaité.

dotnet new worker --name <Project.Name>

Pour plus d’informations sur la commande de création d'un nouveau projet de service worker de .NET CLI, consultez dotnet new worker.

Pour créer un projet de service Worker avec l’interface CLI .NET, ouvrez votre terminal favori dans un répertoire de travail. Exécutez la commande dotnet new et remplacez <Project.Name> par le nom souhaité de votre projet.

dotnet new worker --name <Project.Name>

Pour plus d’informations sur la commande du nouveau projet de service worker cli .NET, consultez dotnet new worker.

Pour générer l’application à partir de Visual Studio, sélectionnez F6 ou sélectionnez l’option de menu Générer> lasolution.

Pour générer l’application à partir de Visual Studio Code, ouvrez la fenêtre de terminal intégrée et exécutez la dotnet build commande à partir du répertoire de travail.

dotnet build

Pour plus d’informations sur la commande de build cli .NET, consultez dotnet build.

Pour générer l’application à partir de l’interface CLI .NET, exécutez la dotnet build commande à partir du répertoire de travail.

dotnet build <path/to/project.csproj>

Spécifiez votre <path/to/project.csproj> valeur, qui est le chemin d’accès au fichier projet à générer. Pour plus d’informations sur la commande de build cli .NET, consultez dotnet build.

Si vous avez correctement coché la case Activer Docker lors de la création d’un projet Worker, passez à l’étape Générer l’image Docker .

Si vous n’avez pas sélectionné cette option, vous pouvez toujours l’ajouter maintenant. Dans Visual Studio, cliquez avec le bouton droit sur le nœud du projet dans l’Explorateur de solutions, puis sélectionnez Ajouter> unsupport Docker. Vous serez invité à sélectionner un système d’exploitation cible ; sélectionnez OK avec la sélection du système d’exploitation par défaut.

Dans Visual Studio Code, vous avez besoin de l’extension Docker et de l’extension compte Azure installée. Ouvrez la palette de commandes, puis sélectionnez l’option Docker : Ajouter des fichiers Docker à l’espace de travail . Si vous êtes invité à sélectionner la plateforme d’applications, choisissez .NET : Console Core. Si vous êtes invité à sélectionner un projet, choisissez le projet De service Worker que vous avez créé. Lorsque vous êtes invité à sélectionner le système d’exploitation, choisissez le premier système d’exploitation répertorié. Lorsque vous y êtes invité à inclure ou non des fichiers Docker Compose facultatifs, sélectionnez Non.

Avec l’interface CLI, le fichier Dockerfilen’est pas créé pour vous. Copiez son contenu dans un nouveau fichier nommé Dockerfile dans le répertoire racine du projet.

Pour plus d’informations sur les images .NET officielles, consultez Docker Hub : .NET Runtime et Docker Hub : Kit de développement logiciel (SDK) .NET.

Cliquez avec le bouton droit sur le fichier Dockerfile dans l’Explorateur de solutions, puis sélectionnez Générer une image Docker. La fenêtre Sortie s’affiche, signalant la progression de la docker build commande.

Cliquez avec le bouton droit sur le fichier Dockerfile dans l’Explorateur, puis sélectionnez Générer une image. Lorsque vous êtes invité à étiqueter l'image comme, entrez appcloudservice:latest. Le terminal de sortie de tâche Docker s’affiche, signalant la progression de la commande de build Docker.

{
  "type": "docker-build",
  "label": "docker-build: release",
  "dependsOn": [
    "build"
  ],
  "dockerBuild": {
    "tag": "appcloudservice:latest",
    "dockerfile": "${workspaceFolder}/cloud-service/Dockerfile",
    "context": "${workspaceFolder}",
    "pull": true
  },
  "netCore": {
    "appProject": "${workspaceFolder}/cloud-service/App.CloudService.csproj"
  }
}

Ouvrez une fenêtre de terminal dans le répertoire racine du fichier Dockerfile, puis exécutez la commande Docker suivante :

docker build -t appcloudservice:latest -f Dockerfile .

Une ressource Azure Container Registry (ACR) vous permet de générer, stocker et gérer des images et artefacts conteneur dans un registre privé. Pour créer un registre de conteneurs, vous devez créer une ressource dans le portail Azure.

1. Sélectionnez l’abonnement et le groupe de ressources correspondant (ou créez-en un).
2. Entrez un nom de Registre.
3. Sélectionnez un emplacement.
4. Sélectionnez une référence SKU appropriée, par exemple De base.
5. Sélectionnez Vérifier + créer.
6. Une fois la validation passée, sélectionnez Créer.

Une ressource Azure Container Registry (ACR) vous permet de générer, stocker et gérer des images et artefacts conteneur dans un registre privé. Ouvrez une fenêtre de terminal dans le répertoire racine du fichier Dockerfile, puis exécutez la commande Azure CLI suivante :

az login

az account set --subscription <subscription name or id>

Une fois que vous vous connectez à Azure CLI, votre session peut interagir avec les ressources en conséquence.

Si vous n’avez pas encore de groupe de ressources auquel vous souhaitez associer votre service worker, créez-en un à l’aide de la az group create commande :

az group create -n <resource group> -l <location>

Indiquez le <resource group> nom et le <location>. Pour créer un registre de conteneurs, appelez la az acr create commande.

az acr create -n <registry name> -g <resource group> --sku <sku> --admin-enabled true

Remplacez les espaces réservés par vos propres valeurs appropriées :

• <registry name>: nom du registre.
• <resource group>: nom du groupe de ressources que vous avez utilisé.
• <sku>: valeurs acceptées, De base, Classique, Premium ou Standard.

La commande précédente :

• Crée un Azure Container Registry, donné un nom de registre, dans le groupe de ressources spécifié.
• Activé un utilisateur administrateur : cela est requis pour Azure Container Instances.

Cliquez avec le bouton droit sur le projet dans l’Explorateur de solutions, puis sélectionnez Publier. La boîte de dialogue Publier s’affiche. Pour la cible, sélectionnez Azure , puis Suivant.

Pour la cible spécifique, sélectionnez Azure Container Registry , puis Suivant.

Ensuite, pour Container Registry, sélectionnez le nom de l’abonnement que vous avez utilisé pour créer la ressource ACR. Dans la zone de sélection des registres de conteneurs, sélectionnez le registre de conteneurs que vous avez créé, puis sélectionnez Terminer.

Cela crée un profil de publication, qui peut être utilisé pour publier l’image dans le registre de conteneurs. Sélectionnez le bouton Publier pour envoyer l’image au registre de conteneurs, la fenêtre Sortie signale la progression de la publication. Une fois l’opération terminée, un message « Publication réussie » s’affiche.

Sélectionnez Docker dans la barre d’activité dans Visual Studio Code. Développez le panneau d’arborescence IMAGES , puis développez le nœud image et cliquez avec le appcloudservice bouton droit sur la latest balise.

La fenêtre de terminal intégrée signale la progression de la docker push commande au registre de conteneurs.

Pour envoyer une image au registre de conteneurs, vous devez d’abord vous connecter au registre :

az acr login -n <registry name>

La az acr login commande se connecte à un registre de conteneurs via l’interface CLI Docker. Pour envoyer (push) l’image au registre de conteneurs, utilisez la commande az acr build avec le nom de votre registre de conteneurs comme suit <registry name>:

az acr build -r <registry name> -t appcloudservice .

La commande précédente :

• Packe la source dans un fichier tar .
• Charge-le dans le registre de conteneurs.
• Le registre de conteneurs décompresse le fichier tar .
• Exécute la commande docker build dans la ressource de registre de conteneurs contre le Dockerfile.
• Ajoute l’image au registre de conteneurs.

Dans Visual Studio Code, sélectionnez Docker dans la barre d’activité. Développez le nœud REGISTRYS , puis sélectionnez Connecter le Registre. Sélectionnez Azure lorsque vous y êtes invité, puis connectez-vous si nécessaire.

Développez le nœud REGISTRIES, sélectionnez Azure, votre abonnement > le registre de conteneurs > l'image, puis cliquez avec le bouton droit sur le tag. Sélectionnez Déployer une image sur Azure Container Instances.

Pour créer une instance de conteneur, commencez par créer un groupe de conteneurs à l’aide de la az container create commande.

az container create -g <resource group> \
  --name <instance name> \
  --image <registry name>.azurecr.io/<image name>:latest \
  --registry-password <password>

Fournissez les valeurs appropriées :

• <resource group>: nom du groupe de ressources que vous avez utilisé dans ce tutoriel.
• <instance name>: nom de l’instance de conteneur.
• <registry name>: nom du registre de conteneurs.
• <image name>: nom de l’image.
• <password> : le mot de passe du registre de conteneurs — vous pouvez l’obtenir à partir du portail Azure, ressource Container Registry >des clés d’accès.

Pour créer une instance de conteneur, vous devez également créer une ressource dans le portail Azure.

1. Sélectionnez le même abonnement et le groupe de ressources correspondant dans la section précédente.
2. Entrez un nom de conteneur.appcloudservice-container
3. Sélectionnez une région qui correspond à la sélection d’emplacement précédente.
4. Pour la source d’image, sélectionnez Azure Container Registry.
5. Sélectionnez le Registre par le nom fourni à l’étape précédente.
6. Sélectionnez Image et balise Image.
7. Sélectionnez Vérifier + créer.
8. En supposant que la validation est passée, sélectionnez Créer.

La création des ressources peut prendre un moment, une fois que vous avez créé, sélectionnez le bouton Accéder à la ressource .

Pour plus d’informations, consultez Démarrage rapide : Créer une instance de conteneur Azure.

Pour vérifier que votre service worker fonctionne correctement, vous pouvez afficher les journaux d’activité de votre application en cours d’exécution. Utilisez la commande az container logs :

az container logs -g <resource group> --name <instance name>

Fournissez les valeurs appropriées :

• <resource group>: nom du groupe de ressources que vous avez utilisé dans ce tutoriel.
• <instance name>: nom de l’instance de conteneur.

Vous verrez les journaux de sortie du service worker .NET, ce qui signifie que vous avez correctement déployé votre application conteneurisée sur ACI.