Déployer une application Kubernetes avec Cloud Code pour IntelliJ

Découvrez comment utiliser Cloud Code pour IntelliJ afin de déployer votre première application Kubernetes.

Dans ce guide de démarrage rapide, vous allez configurer une nouvelle application Kubernetes à l'aide d'un modèle de démarrage Hello World, exécuter votre application sur un cluster, configurer la reconstruction continue pour développer votre application de manière itérative, déboguer votre code en cours d'exécution et afficher les journaux de streaming de votre application active.

Bien que nous vous recommandions d'utiliser Google Cloud pour ce guide, vous pouvez également utiliser Cloud Code avec un cluster local à l'aide d'outils tels que Minikube et Docker Desktop. Toutefois, les fonctionnalités telles que la création de clusters GKE en direct et la diffusion continue intégrée sont plus efficaces avec un projetGoogle Cloud .

Avant de commencer

Que vous choisissiez d'utiliser un cluster local ou hébergé dans le cloud, procédez comme suit pour effectuer ce démarrage rapide :

  1. Installez Git. Git est nécessaire pour copier des exemples de code sur votre ordinateur.
  2. Installez Docker. Docker est nécessaire pour compiler l'exemple de code. Assurez-vous que votre compte utilisateur local peut créer des conteneurs.
  3. Installez le plug-in Cloud Code si ce n'est pas déjà fait.

Pour suivre ce guide de démarrage rapide à l'aide de Google Cloud, procédez comme suit :

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

  4. Verify that billing is enabled for your Google Cloud project.

  5. Enable the Google Kubernetes Engine API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  7. Si vous utilisez un projet existant pour ce guide, vérifiez que vous disposez des autorisations nécessaires pour suivre les instructions. Si vous avez créé un projet, vous disposez déjà des autorisations requises.

  8. Verify that billing is enabled for your Google Cloud project.

  9. Enable the Google Kubernetes Engine API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    10.

    Rôles requis

    Pour obtenir les autorisations nécessaires pour effectuer ce démarrage rapide à l'aide de Google Cloud, demandez à votre administrateur de vous accorder le rôle IAM Administrateur Kubernetes Engine (roles/container.admin) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

    Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Créer une application

Cloud Code est fourni avec un ensemble de modèles d'exemples de code pour vous aider à démarrer. Pour créer une application à l'aide d'un exemple existant :

  1. Dans votre IDE, ouvrez File (Fichier) / New Project (Nouveau projet) et sélectionnez Cloud Code: Kubernetes.

  2. Sélectionnez un modèle Hello World dans la liste d'applications de démarrage. Liste des modèles disponibles : Python, Go, NodeJS, Java Hello World et applications de livre d'or

  3. Indiquez un nom pour votre projet.

    Une fois que vous avez cliqué sur Finish (Terminer), Cloud Code clone le modèle choisi et ouvre le projet que vous venez de créer.

    Pour les modèles Java, vous êtes invité à importer les projets Maven requis pour synchroniser votre fichier pom.xml. Cliquez sur Add as Maven project (Ajouter en tant que projet Maven), puis sur Import Changes (Importer les modifications).

Sélectionnez un cluster

Pour développer votre application, vous aurez besoin d'un cluster Kubernetes associé, hébergé localement avec Minikube ou à l'aide d'une plate-forme cloud, telle qu'un cluster Google Kubernetes Engine.

Cluster local

Si vous n'avez pas encore de cluster à utiliser pour ce démarrage rapide, vous pouvez choisir d'exécuter votre application avec un cluster Minikube local géré par Cloud Code. Cloud Code démarre un cluster Minikube pour exécuter votre application, puis l'arrête lorsque le déploiement s'arrête. Si un cluster Minikube est déjà en cours d'exécution, Cloud Code utilise le cluster Minikube existant pour le déploiement.

Vous pouvez choisir d'utiliser ce cluster Minikube géré par Cloud Code à l'étape suivante, Développer votre application, en le définissant comme préférence de déploiement.

Cluster basé sur Cloud Platform

Si vous avez déjà configuré un cluster pour qu'il fonctionne avec des outils Kubernetes, tels que kubectl, que vous pouvez utiliser pour ce guide de démarrage rapide, Cloud Code se déploie automatiquement. Vous pouvez passer au développement de votre application afin de vérifier que votre cluster préféré est défini comme contexte actif.

Si ce n'est pas le cas, vous pouvez en créer un à l'aide des instructions spécifiques à votre plate-forme cloud. Pour GKE, suivez le guide Créer un cluster.

Développer votre application

Pour lancer le développement de votre application sur Kubernetes :

  1. Si vous utilisez un cluster hébergé sur une plate-forme cloud, assurez-vous d'avoir défini l'emplacement de stockage de vos images de conteneur pour Develop on Kubernetes.

    Si vous êtes connecté à Google Cloud dans votre IDE et qu'un projet par défaut est défini, Cloud Code utilise automatiquement votre dépôt d'images de conteneurs par défaut (gcr.io/{project_id}, où {project_id} fait référence à votre projet par défaut).

  2. Assurez-vous que le contexte Kubernetes préféré est défini. Vous pouvez le spécifier dans votre configuration de développement sur Kubernetes (accessible via Exécuter > Modifier des configurations > Développer sur Kubernetes) dans l'onglet "Exécuter" de la section "Préférences de déploiement".

    Vous pouvez choisir de déployer dans un contexte actif (par défaut), en local dans un cluster Minikube ou dans un autre contexte disponible.

    Par défaut, votre application Kubernetes s'exécute en Mode à la demande avec l'option À la demande sélectionnée. Si vous le souhaitez, vous pouvez au lieu de cela sélectionner l'option Enregistrer sur le fichier.

  3. Choisissez la cible d'exécution Develop on Kubernetes dans le sélecteur de configuration d'exécution/de débogage de la barre de navigation.

    Configurations d'exécution du déploiement sur Kubernetes

    Cela garantit que toutes les modifications de code seront automatiquement créées, transférées et déployées vers une nouvelle version de votre application.

  4. Pour démarrer le cycle de développement sur votre cluster Kubernetes, cliquez sur l'action d'exécution pour Develop on Kubernetes.

  5. Dans la fenêtre de sortie, dans l'onglet Logs (Journaux), affichez les journaux d'applications entrants.

    Une fois le déploiement démarré, la liste des ports transférés pour l'application déployée s'affiche.

  6. Une fois le déploiement effectué, vous êtes informé que de nouvelles URL de service sont disponibles. Cliquez sur l'onglet URL des services pour afficher les URL, puis cliquez sur le lien URL pour ouvrir votre navigateur avec votre application en cours d'exécution.

    Afficher les services transférés sur le port dans l'onglet "URL des services"

    Vous pouvez également ouvrir le journal des événements, puis cliquer sur le lien pour ouvrir votre navigateur avec l'application en cours d'exécution.

    Le volet Ressources déployées affiche ce que vous avez déployé pendant la session de développement.

Déboguer votre application

Cloud Code permet d'appliquer des modifications pendant le débogage.

Pour déboguer votre application, procédez comme suit :

  1. Cliquez sur l'action de débogage Icône d'action de débogage pour Develop on Kubernetes (Développer sur Kubernetes) afin de démarrer le cycle de développement en mode débogage sur votre cluster Kubernetes.

    Démarrer le cycle de développement du cluster Kubernetes en mode débogage

  2. Cloud Code rattache alors une session de débogage. En cas de réussite, la fenêtre "Debug Tool" (Outil de débogage) s'ouvre, confirmant la connexion (dans l'onglet "Console").

    Vous pouvez maintenant déboguer votre cluster Kubernetes opérationnel.

  3. Cliquez sur la marge de la ligne exécutable du code auquel vous souhaitez ajouter un point d'arrêt.

    Les cercles pleins rouges indiquent les points d'arrêt actifs, tandis que les cercles vides rouges indiquent les points d'arrêt désactivés.

  4. Lorsque vous envoyez une nouvelle requête à l'application, celle-ci s'interrompt sur la ligne souhaitée.

    Session de débogage Kubernetes

  5. Pour mettre fin à la session de débogage, cliquez sur l'icône d'arrêt dans la configuration d'exécution Develop on Kubernetes.

Afficher les journaux

En plus d'afficher les journaux des pods en cours d'exécution en tant que flux en direct dans la sortie du terminal à mesure que vous développez et exécutez votre application, vous pouvez consulter les journaux d'un pod spécifique en accédant à l'explorateur Kubernetes.

Pour afficher les journaux d'un pod spécifique, procédez comme suit :

  1. Accédez à l'explorateur Kubernetes. Vous pouvez y accéder depuis le panneau latéral de droite ou en suivant le menu Tools > Cloud Code > Kubernetes > View Cluster Explorer (Outils > Cloud Code > Kubernetes > Afficher l'explorateur de cluster).

    Le panneau de l'explorateur Kubernetes s'ouvre à l'aide de l'onglet de la barre des tâches de droite.

  2. Sélectionnez le pod pour lequel vous souhaitez consulter les journaux.

  3. Effectuez un clic droit sur le pod, puis sélectionnez Stream Logs (Diffuser des journaux). Vous pouvez également diffuser des journaux pour des conteneurs individuels exécutés dans des pods.

    Les journaux sont alors envoyés à la console de l'explorateur Kubernetes.

    Diffusion des journaux d'un pod à l'aide du menu contextuel pour les afficher dans la console de l'explorateur Kubernetes

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre compte Google Cloud , procédez comme suit :

  1. Accédez à la page "Projets" dans la console Google Cloud  :

    Accéder à la page Projets

  2. Sélectionnez le projet que vous avez créé dans ce démarrage rapide, puis cliquez sur l'icône en forme de corbeille située à côté pour le supprimer.

    Cette opération ferme le projet et programme sa suppression.

Étape suivante