Utiliser une application existante

Cloud Code exploite Skaffold dans sa configuration d'origine pour exécuter ou déboguer votre application.

Si une application existante est déjà configurée avec des fichiers manifeste Kubernetes et un fichier Dockerfile pour créer vos images, vous pouvez l'ouvrir et l'utiliser avec Cloud Code.

La seule configuration supplémentaire nécessaire est une configuration Skaffold et une configuration de lancement de type cloudcode.kubernetes. Cloud Code vous aide à les créer lorsque vous exécutez ou déboguez votre application pour la première fois.

Paramétrer la configuration

Si votre application possède un fichier Dockerfile, mais ne dispose pas des configurations Skaffold et de lancement requises, procédez comme suit:

  1. Sélectionnez Run on Kubernetes (Exécuter sur Kubernetes) ou Debug on Kubernetes (Déboguer sur Kubernetes) dans la barre d'état Cloud Code.

    Choix de "Exécuter sur Kubernetes" dans la barre d'état Cloud Code

  2. Dans la boîte de dialogue "Run/Debug on Kubernetes" (Exécuter/Déboguer sur Kubernetes), spécifiez le compilateur souhaité et ses paramètres. Vous pouvez également personnaliser le nom de votre configuration.

    Capture d'écran de la boîte de dialogue "Build settings" (Paramètres de compilation) avec les champs de nom de la configuration et d'options du compilateur

  3. Cliquez sur Déboguer ou sur Exécuter. Les configurations de lancement skaffold.yaml et cloudcode.kubernetes nouvellement créées sont ajoutées à votre espace de travail et votre application s'exécute ou prête à être débogée.

Établir une configuration pour les applications qui possèdent déjà skaffold.yaml

Si votre application dispose déjà d'un fichier skaffold.yaml, procédez comme suit :

  1. Sélectionnez Run on Kubernetes (Exécuter sur Kubernetes) ou Debug on Kubernetes (Déboguer sur Kubernetes) dans la barre d'état Cloud Code.

    Choix de "Exécuter sur Kubernetes" dans la barre d'état Cloud Code

  2. Si votre espace de travail contient plusieurs fichiers skaffold.yaml, sélectionnez votre fichier skaffold.yaml.

    Sélectionner le fichier de configuration Skaffold

  3. Si le fichier skaffold.yaml contient plusieurs profils Skaffold, sélectionnez votre profil Skaffold préféré.

    Sélectionner le profil Skaffold

    La configuration de lancement cloudcode.kubernetes nouvellement créée est ajoutée à votre espace de travail (dans .vscode/launch.json), et votre application est en cours d'exécution ou prête à être débogée.

Créer manuellement une configuration Skaffold

Vous pouvez créer votre configuration Skaffold pour définir les options personnalisées. Cloud Code est fourni avec un modèle actif pour permettre la création manuelle de la configuration de Skaffold.

Pour créer manuellement une configuration Skaffold, procédez comme suit :

  1. Créez un fichier nommé skaffold.yaml dans le répertoire racine de votre espace de travail.

  2. Dans le fichier, appuyez sur Command/Ctrl+Space pour afficher la liste des suggestions d'extraits, puis sélectionnez l'extrait Skaffold - Getting started.

    Créer une configuration Skaffold manuellement

  3. Saisissez le nom de l'image de votre projet dans le champ image, puis saisissez la liste des ressources Kubernetes à déployer dans le champ manifests.

    Exemple pour les builds basés sur Dockerfile :

    build:
      artifacts:
        - image: image_name
    deploy:
      kubectl:
        manifests:
          - k8s/web.yaml
          - k8s/backend.yaml
    

    Si vous souhaitez définir des configurations de compilation, de test et de déploiement pour différents contextes, vous pouvez utiliser plusieurs profils Skaffold. L'exemple suivant montre un profil Cloud Build permettant de configurer Cloud Code pour compiler des images avec Cloud Build:

    profiles:
    # use the cloudbuild profile to build images using Google Cloud Build
    - name: cloudbuild
      build:
        googleCloudBuild: {}
    

    Pour obtenir des informations complètes sur le schéma, consultez le fichier de référence skaffold.yaml.