Démarrage rapide : Générer et déployer à partir d’une source locale sur Azure Container Apps
Cet article explique comment générer et déployer un microservice sur Azure Container Apps à partir de code source local à l’aide du langage de programmation de votre choix. Dans ce guide de démarrage rapide, vous allez créer un service d’API web back-end qui retourne une collection statique d’albums de musique.
Remarque
Cet exemple d’application est disponible en deux versions. Une version où la source contient un fichier Dockerfile. L’autre version n’a pas de fichier Dockerfile. Sélectionnez la version qui reflète le mieux votre code source. Si vous débutez avec les conteneurs, sélectionnez l’option Aucun fichier Dockerfile en haut.
La capture d’écran suivante montre la sortie du service d’API album que vous déployez.
Prérequis
Pour mener à bien ce projet, vous avez besoin des éléments suivants :
| Condition requise | Instructions |
|---|---|
| Compte Azure | Si vous n’en avez pas un, créez un compte gratuitement. Vous avez besoin de l’autorisation Contributeur ou Propriétaire sur l’abonnement Azure pour continuer. Pour plus d’informations, consultez Attribuer des rôles Azure à l’aide du portail Azure. |
| Azure CLI | Installez Azure CLI. |
Programme d’installation
Pour vous connecter à Azure à partir de l’interface CLI, exécutez la commande suivante et suivez les invites pour procéder à l’authentification.
az login
Pour être sûr d’utiliser la dernière version de l’interface CLI, exécutez la commande de mise à niveau.
az upgrade
Ensuite, installez ou mettez à jour l’extension Azure Container Apps pour l’interface CLI.
Si vous recevez des erreurs concernant des paramètres manquants lorsque vous exécutez des commandes az containerapp dans Azure CLI ou les cmdlets du module Az.App dans Azure PowerShell, assurez-vous que la dernière version de l’extension Azure Container Apps est installée.
az extension add --name containerapp --upgrade
Remarque
À compter de mai 2024, les extensions Azure CLI n’activent plus les fonctionnalités en préversion par défaut. Pour accéder aux fonctionnalités en préversion de Container Apps, installez l’extension Container Apps avec --allow-preview true.
az extension add --name containerapp --upgrade --allow-preview true
Maintenant que la version actuelle de l’extension ou du module est installée, inscrivez les espaces de noms Microsoft.App et Microsoft.OperationalInsights.
az provider register --namespace Microsoft.App
az provider register --namespace Microsoft.OperationalInsights
Créer des variables d’environnement
À présent que votre configuration Azure CLI est terminée, vous pouvez définir les variables d’environnement utilisées dans cet article.
Définissez les variables suivantes dans votre interpréteur de commandes Bash.
export RESOURCE_GROUP="album-containerapps"
export LOCATION="canadacentral"
export ENVIRONMENT="env-album-containerapps"
export API_NAME="album-api"
Obtenir l’exemple de code
Téléchargez et extrayez l’exemple d’application d’API dans le langage de votre choix.
Téléchargez le code source sur votre ordinateur.
Extrayez le téléchargement et basculez vers le dossier containerapps-albumapi-csharp-main/src.
Téléchargez le code source sur votre ordinateur.
Extrayez le téléchargement et basculez vers le dossier containerapps-albumapi-csharp-buildpack/src.
Générer, puis déployer l’application conteneur
Générez et déployez votre première application conteneur à l’aide de la commande containerapp up. Cette commande va :
- Créer le groupe de ressources
- Création d’un Azure Container Registry
- Générer l’image conteneur, puis l’envoyer (push) au registre
- Créer l’environnement Container Apps avec un espace de travail Log Analytics
- Créer et déployer l’application conteneur à l’aide de l’image conteneur générée
- Créer le groupe de ressources
- Créer un registre par défaut dans le cadre de votre environnement
- Détecter le langage et le runtime de votre application, et générer l’image à l’aide du Buildpack approprié
- Envoyer (push) l’image dans le registre Azure Container Apps par défaut
- Créer l’environnement Container Apps avec un espace de travail Log Analytics
- Créer et déployer l’application conteneur à l’aide de l’image conteneur générée
La commande up utilise le Dockerfile à la racine du dépôt pour générer l’image conteneur. L’instruction EXPOSE du Dockerfile a défini le port cible, qui est le port utilisé pour envoyer le trafic d’entrée au conteneur.
Si la commande up ne trouve pas de Dockerfile, elle utilise automatiquement Buildpacks pour transformer votre source d’application en conteneur exécutable. Étant donné que Buildpack tente d’exécuter la build en votre nom, vous devez indiquer à la commande up vers quel port envoyer le trafic d’entrée.
Dans l’exemple de code suivant, le . (point) indique à containerapp up de s’exécuter dans le répertoire courant de l’exemple d’application API extrait.
az containerapp up \
--name $API_NAME \
--location $LOCATION \
--environment $ENVIRONMENT \
--source .
az containerapp up \
--name $API_NAME \
--location $LOCATION \
--environment $ENVIRONMENT \
--ingress external \
--target-port 8080 \
--source .
Important
Pour déployer votre application conteneur dans un groupe de ressources existant, ajoutez --resource-group yourResourceGroup à la commande containerapp up.
Vérifier le déploiement
Copiez le nom de domaine complet dans un navigateur web. Depuis votre navigateur web, accédez au point de terminaison /albums du nom de domaine complet.
Limites
La taille maximale pour le chargement du code source est de 200 Mo. Si le chargement dépasse la limite, une erreur 413 est retournée.
Nettoyer les ressources
Si vous ne passez pas au tutoriel Déployer un front-end, vous pouvez supprimer les ressources Azure créées lors de ce démarrage rapide avec la commande suivante.
Attention
La commande suivante supprime le groupe de ressources spécifié et toutes les ressources qu’il contient. Si le groupe contient des ressources ne concernant pas ce démarrage rapide, ces ressources sont également supprimées.
az group delete --name $RESOURCE_GROUP
Conseil
Vous rencontrez des problèmes ? Faites-le nous savoir sur GitHub en ouvrant un problème dans le dépôt Azure Container Apps.
Étapes suivantes
Après avoir terminé ce guide de démarrage rapide, vous pouvez passer à Tutoriel : communication entre les microservices dans Azure Container Apps pour apprendre à déployer une application front-end qui appelle l’API.