Déployer dans l'environnement flexible App Engine

Ce document explique comment déployer une application App Engine dans l'environnement flexible App Engine à partir d'IntelliJ IDEA.

Avant de commencer

  • Suivez les instructions du guide Créer une application pour installer et configurer Cloud Code, ainsi que pour créer une application App Engine pour l'environnement flexible. Veillez à ajouter la compatibilité avec le framework flexible App Engine.

    Si vous ne possédez pas d'application mais souhaitez tout de même essayer les procédures de déploiement, téléchargez l'exemple d'application :

    1. Clonez l'exemple d'application Spring Boot sur votre ordinateur local :

       git clone https://github.com/spring-guides/gs-spring-boot
      
    2. Dans IntelliJ, sélectionnez File > Open (Fichier > Ouvrir) pour ouvrir le sélecteur de fichiers.

    3. Accédez à /gs-spring-boot/.

    4. Sélectionnez le répertoire /complete/.

    5. Cliquez sur OK.

    6. Ajoutez la compatibilité avec le framework flexible App Engine.

Créer la configuration de déploiement

  1. Sélectionnez Tools > Cloud Code > App Engine > Deploy to App Engine (Outils > Cloud Code > App Engine > Déployer dans App Engine).

    Boîte de dialogue de création d'une configuration de déploiement. Contient les champs Name (Nom), Server (Serveur), Deployment (Déploiement), Project (Projet), Version et app.yaml.

  2. Confirmez la configuration du serveur :

    1. Cliquez sur les points de suspension (...) en regard du champ Server (Serveur).

    2. Dans la boîte de dialogue, vérifiez que le champ Name (Nom) affiche Google App Engine.

    3. Cliquez sur OK.

  3. Sélectionnez la source du déploiement dans le champ Deployment.

    Cloud Code for IntelliJ prend en charge le déploiement à partir d'un artefact Maven, spécifique à IntelliJ ou d'un fichier JAR ou WAR.

    1. Si vous sélectionnez un fichier JAR ou WAR comme source de déploiement, cliquez sur les points de suspension (...) en regard du champ Deployment archive (Archive de déploiement) pour accéder à l'archive de déploiement.
  4. Sélectionnez un projet dans le champ Project.

    La première fois que vous configurez le déploiement, vous êtes invité à vous connecter au compte associé au projet Cloud Console que vous souhaitez déployer.

  5. Dans la section App Engine Flexible Configuration (Configuration de l'environnement flexible App Engine), sélectionnez un fichier app.yaml valide.

    1. Si vous ne voyez pas de fichier app.yaml valide dans le menu déroulant, cliquez sur Edit (Modifier) pour sélectionner un fichier. Reportez-vous à la section Mettre à jour les configurations flexibles App Engine pour plus d'informations.
  6. Renseignez les autres champs nécessaires pour configurer le déploiement.

  7. Cliquez sur Run (Exécuter) pour créer et déployer votre application.

  8. Dans la fenêtre Application Servers (Serveurs d'applications), cliquez sur le nom de votre projet pour surveiller la progression de son déploiement. Si la fenêtre ne s'affiche pas, cliquez sur Affichage > Fenêtres d'outils > Serveurs d'applications.

    Une fois le déploiement terminé, vous pouvez consulter l'URL de votre application dans la sortie de la console.

Déployer dans un environnement d'exécution personnalisé

Vous pouvez modifier votre fichier app.yaml pour déployer votre application dans un environnement d'exécution personnalisé à l'aide d'un fichier Docker.

  1. Dans votre fichier app.yaml, définissez votre environnement d'exécution sur custom (personnalisé).

  2. À la fin de la procédure de création de la configuration de déploiement, la section App Engine Flexible Configuration (Configuration de l'environnement flexible App Engine) affiche le chemin d'accès à vos fichiers app.yaml et Docker.

    Boîte de dialogue affichant la section de configuration de l'environnement flexible App Engine de l'écran de création de configuration de déploiement. Un champ indique le chemin d'accès au fichier app.yaml. Le bouton Edit (Modifier) permet de sélectionner un autre fichier. Le libellé "custom" indique que l'environnement d'exécution est personnalisé. Le libellé "Docker directory" indique le chemin d'accès au fichier Docker. Le champ "Staged artifact name" indique le chemin d'accès au fichier Docker.

  3. Cliquez sur Edit (Modifier) pour sélectionner des fichiers app.yaml et Docker valides.

    Boîte de dialogue affichant la section de configuration de l'environnement flexible App Engine de l'écran de création de configuration de déploiement. Un champ indique le chemin d'accès au fichier app.yaml. Le bouton Edit (Modifier) permet de sélectionner un autre fichier. Le libellé "custom" indique que l'environnement d'exécution est personnalisé. Le libellé "Docker directory" indique le chemin d'accès au fichier Docker. Le champ "Staged artifact name" indique le chemin d'accès au fichier Docker.

  4. Cliquez sur les points de suspension (...) à côté des champs app.yaml et Dockerfile Directory (Répertoire Dockerfile) pour accéder aux fichiers appropriés.

  5. Cliquez sur OK.

Mettre à jour les configurations flexibles App Engine

Après avoir créé la configuration de déploiement initiale, vous pouvez modifier cette configuration selon les besoins de votre application.

  1. Sélectionnez File > Project Structure (Fichier > Structure du projet).

    La boîte de dialogue Project Structure (Structure du projet) s’affiche.

  2. Sous Project Settings (Paramètres du projet), sélectionnez Facets (Attributs).

  3. Sélectionnez l'attribut Google App Engine Flexible.

  4. Pour sélectionner un fichier app.yaml, cliquez sur les points de suspension (…) à côté du champ app.yaml pour accéder à l'emplacement d'un fichier valide.

  5. Si vous déployez dans un environnement d'exécution personnalisé, cliquez sur les points de suspension (...) en regard du champ Dockerfile directory (Répertoire Dockerfile) pour accéder à l'emplacement d'un fichier valide.

  6. Cliquez sur "OK".

Supprimer le serveur

Si vous souhaitez supprimer le serveur que vous avez configuré pour votre projet, procédez comme suit :

  1. Choisissez File > Settings > Build, Execution, Deployment > Cloud (Fichier > Paramètres > Build, Exécution, Déploiement > Clouds).

    Sur macOS, sélectionnez IntelliJ IDEA > Preferences > Build, Execution, Deployment > Clouds (IntelliJ > Préférences > Compilation, exécution, déploiement > Clouds).

  2. Sélectionnez votre serveur (App Engine) et cliquez sur le signe moins (-) en haut de la fenêtre pour le supprimer.

  3. Cliquez sur OK.

Étape suivante

Assistance

Pour envoyer des commentaires ou signaler un problème dans votre IDE IntelliJ, accédez à Tools > Cloud Code > Aide / À propos > Envoyez des commentaires ou signalez un problème pour signaler un problème sur GitHub, ou posez une question sur Stack Overflow.

Vous pouvez également rejoindre la chaîne #cloud-code, qui fait partie de la communauté Slack Google Cloud.