Guide de démarrage rapide : déployer un service PHP sur Cloud Run

Guide de démarrage rapide : déployer un service PHP sur Cloud Run

Découvrez comment créer une application Hello World simple, l'intégrer dans une image de conteneur, importer l'image de conteneur dans Artifact Registry, puis déployer l'image de conteneur dans Cloud Run. Vous pouvez utiliser d'autres langages en plus de ceux présentés.

Avant de commencer

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Installez Google Cloud CLI.

5. Pour initialiser gcloudCLI, exécutez la commande suivante :

   gcloud init

   Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.

6. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

   Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu de sélectionner un projet existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

   Accéder au sélecteur de projet

7. Vérifiez que la facturation est activée pour votre projet Google Cloud.

8. Installez Google Cloud CLI.

9. Pour initialiser gcloudCLI, exécutez la commande suivante :

   gcloud init

   Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
10. Pour définir le projet par défaut pour votre service Cloud Run :

     gcloud config set project PROJECT_ID

    Remplacez PROJECT_ID par le nom du projet que vous avez créé pour ce guide de démarrage rapide.

11. Si vous êtes soumis à une règle d'administration de restriction de domaine limitant les appels non authentifiés pour votre projet, vous devez accéder au service déployé comme décrit dans la section Tester les services privés.

Coder l'exemple d'application

Pour écrire une application en PHP, procédez comme suit :

1. Créez un répertoire nommé helloworld-php et modifiez les sous-répertoires comme suit :

   mkdir helloworld-php
   cd helloworld-php
   

2. Créez un fichier nommé index.php et collez-y le code suivant :

   <?php
   
   $name = getenv('NAME', true) ?: 'World';
   echo sprintf('Hello %s!', $name);
   

   Ce code répond aux requêtes avec notre message d'accueil "Hello World!". Le traitement HTTP est effectué par un serveur Web Apache dans le conteneur.

3. Créez un fichier nommé Dockerfile dans le même répertoire que les fichiers sources. Le fichier Dockerfile PHP démarre un serveur Web Apache qui écoute le port défini par la variable d'environnement PORT :

   
   # Use the official PHP image.
   # https://hub.docker.com/_/php
   FROM php:8.0-apache
   
   # Configure PHP for Cloud Run.
   # Precompile PHP code with opcache.
   RUN docker-php-ext-install -j "$(nproc)" opcache
   RUN set -ex; \
     { \
       echo "; Cloud Run enforces memory & timeouts"; \
       echo "memory_limit = -1"; \
       echo "max_execution_time = 0"; \
       echo "; File upload at Cloud Run network limit"; \
       echo "upload_max_filesize = 32M"; \
       echo "post_max_size = 32M"; \
       echo "; Configure Opcache for Containers"; \
       echo "opcache.enable = On"; \
       echo "opcache.validate_timestamps = Off"; \
       echo "; Configure Opcache Memory (Application-specific)"; \
       echo "opcache.memory_consumption = 32"; \
     } > "$PHP_INI_DIR/conf.d/cloud-run.ini"
   
   # Copy in custom code from the host machine.
   WORKDIR /var/www/html
   COPY . ./
   
   # Use the PORT environment variable in Apache configuration files.
   # https://cloud.google.com/run/docs/reference/container-contract#port
   RUN sed -i 's/80/${PORT}/g' /etc/apache2/sites-available/000-default.conf /etc/apache2/ports.conf
   
   # Configure PHP for development.
   # Switch to the production php.ini for production operations.
   # RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
   # https://github.com/docker-library/docs/blob/master/php/README.md#configuration
   RUN mv "$PHP_INI_DIR/php.ini-development" "$PHP_INI_DIR/php.ini"
   

4. Ajoutez un fichier .dockerignore pour exclure des fichiers de votre image de conteneur.

   # The .dockerignore file excludes files from the container build process.
   #
   # https://docs.docker.com/engine/reference/builder/#dockerignore-file
   
   # Exclude locally vendored dependencies.
   vendor/
   
   # Exclude "build-time" ignore files.
   .dockerignore
   .gcloudignore
   
   # Exclude git history and configuration.
   .gitignore

Votre application est terminée et prête à être déployée.

Déployer une image sur Cloud Run depuis une source

Important : Dans ce guide de démarrage rapide, nous partons du principe que vous disposez de rôles de propriétaire ou d'éditeur dans le projet que vous utilisez pour les besoins du guide de démarrage rapide. Sinon, reportez-vous aux sections Autorisations de déploiement Cloud Run, Autorisations Cloud Build et Autorisations Artifact Registry pour connaître les autorisations requises.

Cette fonction crée automatiquement une image de conteneur à partir du code source et la déploie.

Pour déployer depuis la source :

1. Dans le répertoire du code source, déployez depuis la source en exécutant la commande suivante :

   gcloud run deploy

   Si vous êtes invité à activer l'API, répondez y pour l'activer.

   1. Lorsque vous êtes invité à saisir l'emplacement du code source, appuyez sur la touche Entrée pour déployer le dossier actuel.

   2. Lorsque vous êtes invité à saisir le nom du service, appuyez sur Entrée pour accepter le nom par défaut, par exemple helloworld.

   3. Si vous êtes invité à activer l'API Artifact Registry ou à autoriser la création du dépôt Artifact Registry, répondez par l'affirmative en appuyant sur y.

   4. Lorsque vous êtes invité à indiquer la région, sélectionnez la région de votre choix, par exemple us-central1.

   5. Vous serez invité à autoriser les appels non authentifiés : répondez y.

   Patientez quelques instants jusqu'à la fin du déploiement. En cas de réussite, la ligne de commande affiche l'URL du service.

2. Accédez à votre service déployé en ouvrant l'URL du service dans un navigateur Web.

Emplacements Cloud Run

Cloud Run est régional, ce qui signifie que l'infrastructure qui exécute vos services Cloud Run est située dans une région spécifique et gérée par Google pour être disponible de manière redondante dans toutes les zones de cette région.

Lors de la sélection de la région dans laquelle exécuter vos services Cloud Run, vous devez tout d'abord considérer vos exigences en matière de latence, de disponibilité et de durabilité. Vous pouvez généralement sélectionner la région la plus proche de vos utilisateurs, mais vous devez tenir compte de l'emplacement des autres produits Google Cloud utilisés par votre service Cloud Run. L'utilisation conjointe de produits Google Cloud dans plusieurs emplacements peut avoir une incidence sur la latence et le coût de votre service.

Cloud Run est disponible dans les régions suivantes :

Soumis aux tarifs de niveau 1

• asia-east1 (Taïwan)
• asia-northeast1 (Tokyo)
• asia-northeast2 (Osaka)
• europe-north1 (Finlande) Faibles émissions de CO₂
• europe-southwest1 (Madrid)
• europe-west1 (Belgique) Faibles émissions de CO₂
• europe-west4 (Pays-Bas)
• europe-west8 (Milan)
• europe-west9 (Paris) Faibles émissions de CO₂
• me-west1 (Tel Aviv)
• us-central1 (Iowa)  Faibles émissions de CO₂
• us-east1 (Caroline du Sud)
• us-east4 (Virginie du Nord)
• us-east5 (Columbus)
• us-south1 (Dallas)
• us-west1 (Oregon)  Faibles émissions de CO₂

Soumis aux tarifs de niveau 2

• africa-south1 (Johannesburg)
• asia-east2 (Hong Kong)
• asia-northeast3 (Séoul, Corée du Sud)
• asia-southeast1 (Singapour)
• asia-southeast2 (Jakarta)
• asia-south1 (Mumbai, Inde)
• asia-south2 (Delhi, Inde)
• australia-southeast1 (Sydney)
• australia-southeast2 (Melbourne)
• europe-central2 (Varsovie, Pologne)
• europe-west10 (Berlin)
• europe-west12 (Turin)
• europe-west2 (Londres, Royaume-Uni) Faibles émissions de CO₂
• europe-west3 (Francfort, Allemagne) Faibles émissions de CO₂
• europe-west6 (Zurich, Suisse) Faibles émissions de CO₂
• me-central1 (Doha)
• me-central2 (Dammam)
• northamerica-northeast1 (Montréal) Faibles émissions de CO₂
• northamerica-northeast2 (Toronto)  Faibles émissions de CO₂
• southamerica-east1 (São Paulo, Brésil)  Faibles émissions de CO₂
• southamerica-west1 (Santiago, Chili) Faibles émissions de CO₂
• us-west2 (Los Angeles)
• us-west3 (Salt Lake City)
• us-west4 (Las Vegas)

Si vous avez déjà créé un service Cloud Run, vous pouvez afficher la région dans le tableau de bord Cloud Run de la console Google Cloud.

OK

Félicitations ! Vous venez de déployer une image de conteneur depuis le code source vers Cloud Run. Cloud Run effectue un scaling automatique et horizontal de votre image de conteneur pour traiter les requêtes reçues, puis un scaling vertical lorsque la demande diminue. Vous ne payez que pour le processeur, la mémoire et le réseau utilisés lors du traitement des requêtes.

Effectuer un nettoyage

Supprimer le projet de test

Bien que Cloud Run ne facture pas lorsque le service n'est pas utilisé, il se peut que des frais vous soient facturés pour le stockage de l'image de conteneur dans Artifact Registry. Vous pouvez supprimer votre image de conteneur ou votre projet Google Cloud afin d'éviter que des frais ne vous soient facturés. La suppression de votre projet Google Cloud arrête la facturation de toutes les ressources utilisées dans ce projet.

Attention : La suppression d'un projet aura les effets suivants :
• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches de ce document, lorsque vous le supprimez, vous supprimez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.
1. Dans la console Google Cloud, accédez à la page Gérer les ressources.

   Accéder à la page Gérer les ressources

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Étapes suivantes

Pour savoir comment créer un conteneur à partir d'une source de code et le transférer vers un dépôt, consultez la section suivante :

• Développer votre service Cloud Run
• Créer des conteneurs
• Déployer des fonctions à partir du code source