Cette page explique comment lancer la solution Apigee Developer Portal Kickstart depuis Cloud Marketplace à l'aide des options de configuration par défaut.
Dans de nombreux cas, il existe plusieurs options pour personnaliser un portail en fonction de vos besoins en termes de scaling, de sécurité ou de surveillance. Consultez la page Personnaliser la solution Apigee Developer Portal Kickstart dans Cloud Marketplace pour connaître les options de personnalisation spécifiques à prendre en compte avant de déployer votre portail.
Avant de commencer
L'objectif de ce tutoriel est de vous familiariser avec les étapes requises pour une configuration par défaut d'un portail.
Avant de déployer un portail pour des tests ou une utilisation en production, consultez la section
Personnaliser la solution de lancement du portail des développeurs Apigee dans Cloud Marketplace pour connaître les étapes de configuration nécessaires pour les tâches suivantes :
Lancer une nouvelle solution de lancement du portail des développeurs Apigee
Suivez les étapes ci-dessous pour configurer et déployer la solution de lancement du portail des développeurs Apigee à partir de Cloud Marketplace :
Dans la console Google Cloud, accédez à la page Cloud Marketplace, puis sélectionnez la solution Lancement du portail des développeurs Apigee.
Cliquez sur Lancer.
Configurez le déploiement du nouveau portail des développeurs Apigee.
Saisissez le nom du déploiement. Par exemple, portal-dev. Le nom de votre déploiement :
Ne doit pas dépasser 10 caractères.
Correspondre à l'expression régulière [a-z]([-a-z0-9]*[a-z0-9])?. Cela signifie que le premier caractère doit être une lettre minuscule, et tous les caractères suivants doivent être des tirets, des lettres minuscules ou des chiffres, à l'exception du dernier caractère, qui ne peut pas être un tiret.
Dans la liste déroulante, sélectionnez la zone de votre choix pour votre déploiement. Pour en savoir plus sur les ressources Compute Engine disponibles dans différentes zones, consultez la page Régions et zones.
Sélectionnez le type de machine de l'instance Compute Engine dans la liste déroulante.
La valeur par défaut est 1vCPU.
Facultatif : cliquez sur Personnaliser pour modifier le type de machine, les cœurs et la mémoire sélectionnés pour
l'instance Compute Engine.
Créez un compte de service ou sélectionnez un compte de service existant pour les instances Compute Engine de votre déploiement. Le compte de service est utilisé par Compute Engine pour accéder à d'autres API Google.
Pour créer un compte de service, fournissez les informations suivantes :
Nom du compte de service : cet identifiant unique apparaît dans l'adresse e-mail du compte de service, qui est provisionnée pendant la création. Par exemple, sa-name@project-id.iam.gserviceaccount.com.
ID de compte de service : l'ID doit comporter entre 6 et 30 caractères, et peut contenir des caractères alphanumériques minuscules et des tirets.
Description du compte de service : brève description du compte de service
Pour sélectionner un compte de service existant, sélectionnez un compte de service dans la liste déroulante des comptes de service disponibles dans votre projet avec les rôles appropriés.
Facultatif : Configurez les options de disque de démarrage :
Sélectionnez le type de disque de démarrage dans la liste déroulante. La valeur par défaut est
Standard Persistent Disk.
Sélectionnez la taille du disque de démarrage dans la liste déroulante. La valeur par défaut est
200GB.
Consultez la page Options de stockage pour comparer les options de stockage et les tarifs des disques.
Facultatif : configurez les options de mise en réseau :
Les nouveaux portails sont provisionnés avec une adresse IP par défaut pour se connecter à l'instance Cloud SQL.
Si vous le souhaitez, cochez la case pour configurer HTTPS sur le nouveau portail à l'aide d'un domaine nip.io.
nip.io est un service tiers pouvant fournir un DNS générique pour une adresse IP.
Si vous souhaitez utiliser nip.io pour le développement et les tests, vous pouvez modifier le domaine dans la configuration de l'équilibreur de charge avant de l'utiliser en production. Pour découvrir un exemple des étapes requises, consultez la page Utiliser un domaine de test.
Facultatif : configurez Cloud Logging et Cloud Monitoring :
Cloud Logging et Cloud Monitoring sont activés par défaut pour les nouveaux déploiements Apigee Developer Portal Kickstart par défaut.
Pour désactiver l'un des services cloud, décochez la case correspondante.
Pour en savoir plus sur les options de configuration, consultez la documentation de Cloud Logging et de Cloud Monitoring.
Facultatif : configurez les options de chiffrement :
Par défaut, la solution Apigee Developer Portal Kickstart utilise des clés de chiffrement gérées par Google pour sécuriser l'accès à votre instance Cloud SQL.
Pour utiliser une clé de chiffrement gérée par le client (CMEK) configurée pour sécuriser l'accès à Cloud SQL, saisissez le nom de ressource de la clé de chiffrement dans le champ de texte.
Cliquez sur Déployer.
Félicitations, vous avez déployé avec succès une solution de lancement du portail des développeurs Apigee.
Afficher le déploiement de votre portail
Pour afficher les détails du déploiement de votre portail :
Sur la page de solution de lancement du portail des développeurs Apigee, cliquez sur Afficher les déploiements précédents.
Vous êtes redirigé vers le tableau de bord Gestionnaire de déploiement.
Pour afficher les détails d'un déploiement de portail donné, sélectionnez le déploiement de votre choix dans la liste. La page d'informations recommande les étapes suivantes, renvoie vers des documents supplémentaires, et fournit des liens et des identifiants pour des services cloud provisionnés, y compris les suivants :
Groupe d'instances
Instance Cloud SQL
Instance Filestore
Règle de pare-feu
Équilibreur de charge
Pour plus d'informations sur la gestion, la mise à jour et la suppression de déploiements, consultez la documentation du
Gestionnaire de déploiement.
Effectuer un nettoyage
Pour éviter que les ressources utilisées lors de ce guide de démarrage rapide ne soient facturées sur votre compte Google Cloud, vous pouvez supprimer le déploiement. Vous pouvez également supprimer le projet Google Cloud utilisé dans ce tutoriel.
Obtenez plus d'informations sur les ressources d'assistance de la solution de lancement du portail des développeurs Apigee.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis page outlines how to launch the Apigee Developer Portal Kickstart solution from the Cloud Marketplace using default configuration settings for Apigee and Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eBefore deploying a portal, users should consider customizations such as private IP addresses, customer-managed encryption keys, connecting to an Apigee org, configuring HTTPS, or launching a production-ready portal.\u003c/p\u003e\n"],["\u003cp\u003eTo deploy the portal, users must navigate to the Apigee Developer Portal Kickstart in the Cloud Marketplace, configure deployment settings like name, zone, and machine type, and optionally customize boot disk, networking, logging, monitoring, and encryption options.\u003c/p\u003e\n"],["\u003cp\u003eAfter deployment, users can view details, manage, update, or delete the deployment via the Deployment Manager dashboard, which also provides links to provisioned Cloud services and next steps for the user.\u003c/p\u003e\n"],["\u003cp\u003eUsers can avoid incurring charges by deleting their deployment and project after use, and they can find support resources and further customization options through the provided links.\u003c/p\u003e\n"]]],[],null,["# Get started with Apigee Developer Portal Kickstart from Cloud Marketplace\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nThis page describes how to launch the Apigee Developer Portal Kickstart solution from Cloud Marketplace\nwith *default* configuration options.\n\nIn many cases, there are multiple options for portal customization to suit your scaling, security, or monitoring needs. See [Customize the Apigee Developer Portal Kickstart solution in Cloud Marketplace](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize) for specific customization options\nto consider before deploying your portal.\n\nBefore you begin\n----------------\n\nThis tutorial is intended to familiarize you with the steps required for a default portal configuration.\nBefore you deploy a portal for testing or production usage, see [Customize the Apigee Developer Portal Kickstart solution in Cloud Marketplace](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize) for the prerequisite configuration steps needed for the following tasks:\n\n- [Configure a private IP address for using CloudSQL in a VPC network](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize#vpc-service-controls)\n- [Use customer-managed encryption keys for your deployment](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize#cmek)\n- [Connect your portal to an Apigee or Apigee hybrid org](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize#connect)\n- [Configure HTTPS for testing](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize#https)\n- [Launch a production-ready portal](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize#production)\n\nLaunching a new Apigee Developer Portal Kickstart\n-------------------------------------------------\n\nFollow the steps below to configure and deploy the Apigee Developer Portal Kickstart solution from Cloud Marketplace:\n\n1. In the Google Cloud console, go to the [Cloud Marketplace page](https://console.cloud.google.com/marketplace) and select the **Apigee Developer Portal Kickstart** solution.\n2. Click **Launch**.\n3. Configure the **New Apigee Developer Portal deployment** .\n 1. Enter the **Deployment name** . For example, `portal-dev`. The name of your deployment:\n - Should not exceed 10 characters.\n - Match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?`. This means that the first character must be a lowercase letter, and all the following characters must be hyphens, lowercase letters, or digits, except the last character, which cannot be a hyphen.\n - See Compute Engine guidelines on [Naming conventions](https://cloud.google.com/compute/docs/naming-resources#resource-name-format) for addition details.\n 2. Select the **Preferred Zone** for your deployment from the dropdown list. For more details regarding Compute Engine resources available in various zones, see [Regions and Zones](https://cloud.google.com/compute/docs/regions-zones).\n 3. Select the **Machine type** for the Compute Engine instance from the dropdown list. The default value is `1vCPU`.\n - Optional: Click **Customize** to change the selected **Machine type** , **Cores** , and **Memory** for the Compute Engine instance.\n - See [Creating a VM Instance with a custom machine type](https://cloud.google.com/compute/docs/instances/creating-instance-with-custom-machine-type)for more information on machine type customization options.\n 4. **Create a new Service Account** or **Select an existing Service Account** for the Compute Engine instances in your deployment. The Service Account is used by Compute Engine to access other Google APIs.\n - To create a new Service account, provide the following information:\n - **Service account name** : This unique identifier will appear in the service account's email address that is provisioned during creation. For example, \u003cvar translate=\"no\"\u003esa-name\u003c/var\u003e`@`\u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e`.iam.gserviceaccount.com`.\n - **Service account ID**: The ID must be between 6 and 30 characters, and can contain lowercase alphanumeric characters and dashes.\n - **Service account description**: a brief description of the service account\n - See [Creating a service account](https://cloud.google.com/iam/docs/creating-managing-service-accounts) for additional details.\n - To select an existing Service Account, **Select a Service Account** from the dropdown list of available Service Accounts within your project with the correct roles.\n | **Note** : The existing Service Account must have the following roles: `\n | `\n | - roles/storage.objectViewer\n | - roles/logging.logWriter\n | - roles/runtimeconfig.admin\n | - roles/apigee.developerAdmin\n | - roles/cloudsql.client\n | - roles/monitoring.metricWriter\n | `\n | `\n 5. Optional: Configure Boot Disk options:\n - Select the **Boot disk type** from the dropdown list. The default value is `\n Standard Persistent Disk`.\n - Select the **Boot disk size** from the dropdown list. The default value is `\n 200GB`.\n - See [Storage options](https://cloud.google.com/compute/docs/disks) for a comparison of storage options and disk pricing.\n 6. Optional: Configure **Networking** options:\n - New portals are provisioned with a default IP address for connecting to the CloudSQL instance.\n - Optionally, select the checkbox to configure HTTPS on the new portal using an `nip.io` domain. [nip.io](https://nip.io/) is a third-party service that can provide a wildcard DNS for an IP address. If you wish to use `nip.io` for development and testing, you can modify the domain in the load balancer configuration prior to production use. See [Using a\n testing domain](https://cloud.google.com/anthos/run/docs/default-domain) for an example of the steps required.\n 7. Optional: Configure **Cloud Logging and Monitoring** :\n - Cloud Logging and Cloud Monitoring are enabled for new Apigee Developer Portal Kickstart deployments by default.\n - To disable either Cloud service, uncheck the corresponding box.\n - See the [Cloud Logging](https://cloud.google.com/logging/docs) and [Cloud Monitoring](https://cloud.google.com/monitoring/docs) documentation for more details on configuration options.\n 8. Optional: Configure **Encryption** options:\n - By default, the Apigee Developer Portal Kickstart uses [Google Managed Encryption Keys](https://cloud.google.com/storage/docs/encryption/default-keys) to secure access to your Cloud SQL instance.\n - To use a configured customer-managed encryption key (CMEK) to secure access to Cloud SQL, enter the **Resource Name of the Encryption key** in the text field.\n 9. Click **Deploy**.\n\n Congratulations, you have successfully deployed a Apigee Developer Portal Kickstart!\n\n Viewing your portal deployment\n ------------------------------\n\n\n To see the details of your portal deployment:\n 1. From the Apigee Developer Portal Kickstart page, click **View Past deployments** . This will take you to the [**Deployment Manager**](https://console.cloud.google.com/dm/deployments) dashboard.\n 2. To view the details of a given portal deployment, select the desired portal deployment from the list. The detail page will recommend next steps, link to additional documentation, and provide links and IDs for provisioned Cloud services, including the following:\n - Instance Group\n - Cloud SQL Instance\n - Filestore Instance\n - Firewall Rule\n - Load Balancer\n 3. For more information on managing, updating, and deleting deployments, see the [Deployment Manager](https://cloud.google.com/deployment-manager/docs) documentation.\n\n Clean up\n --------\n\n To avoid incurring charges to your Google Cloud account for the resources used in this quickstart, you can [delete your deployment](https://console.cloud.google.com/dm/deployments). You can also delete the Google Cloud project used for this tutorial.\n\n What's next\n -----------\n\n - Additional options for [Customize the Apigee Developer Portal Kickstart solution in Cloud Marketplace](/apigee/docs/api-platform/publish/drupal/apigee-cloud-marketplace-customize).\n - Learn more about [Support resources](/apigee/docs/api-platform/publish/drupal/get-support-cloud-marketplace) for the Apigee Developer Portal Kickstart solution."]]
