Questa pagina descrive come avviare la soluzione Apigee Developer Portal Kickstart da Cloud Marketplace
con le opzioni di configurazione predefinite.
In molti casi, sono disponibili più opzioni per la personalizzazione del portale in base alle tue esigenze di scalabilità, sicurezza o monitoraggio. Consulta
Personalizzare la soluzione Apigee Developer Portal Kickstart in Cloud Marketplace per opzioni di personalizzazione specifiche
da considerare prima di eseguire il deployment del portale.
Prima di iniziare
Questo tutorial ha lo scopo di farti familiarizzare con i passaggi necessari per una configurazione predefinita del portale.
Prima di eseguire il deployment di un portale per i test o l'utilizzo in produzione, consulta
Personalizzare la soluzione Apigee Developer Portal Kickstart in Cloud Marketplace per i passaggi di configurazione dei prerequisiti necessari per le seguenti attività:
Lancio di un nuovo Apigee Developer Portal Kickstart
Per configurare e implementare la soluzione Apigee Developer Portal Kickstart da Cloud Marketplace:
In Google Cloud console, vai alla
pagina Cloud Marketplace e seleziona la soluzione Apigee Developer Portal Kickstart.
Fai clic su Launch .
Configura il Deployment del nuovo portale per gli sviluppatori Apigee.
Inserisci il nome del deployment. Ad esempio, portal-dev. Il nome del deployment:
Non deve superare i 10 caratteri.
Corrisponde all'espressione regolare [a-z]([-a-z0-9]*[a-z0-9])?. Ciò significa che il primo carattere deve essere una lettera minuscola e tutti i caratteri successivi devono essere trattini, lettere minuscole o numeri, tranne l'ultimo carattere, che non può essere un trattino.
Seleziona la zona preferita per la tua implementazione dall'elenco a discesa. Per ulteriori
dettagli sulle risorse di Compute Engine disponibili in varie zone, consulta Regioni e zone.
Seleziona il Tipo di macchina per l'istanza Compute Engine dall'elenco a discesa.
Il valore predefinito è 1vCPU.
(Facoltativo) Fai clic su Personalizza per modificare il Tipo di macchina,
i Core e la Memoria selezionati per
l'istanza Compute Engine.
Crea un nuovo service account o Seleziona un service account esistente
per le istanze Compute Engine nel deployment. Il service account viene utilizzato da Compute Engine per accedere ad altre API di Google.
Per creare un nuovo service account, fornisci le seguenti informazioni:
Nome del service account: questo identificatore univoco verrà visualizzato nell'indirizzo email del service account di cui viene eseguito il provisioning durante la creazione. Ad esempio, sa-name@project-id.iam.gserviceaccount.com.
ID account di servizio: l'ID deve essere compreso tra 6 e 30 caratteri e può
contenere caratteri alfanumerici minuscoli e trattini.
Descrizione service account: una breve descrizione del account di servizio
Per selezionare un service account esistente, Seleziona un service account dall'elenco a discesa
dei service account disponibili nel tuo progetto con i ruoli corretti.
(Facoltativo) Configura le opzioni del disco di avvio:
Seleziona il Tipo di disco di avvio dall'elenco a discesa. Il valore predefinito è
Standard Persistent Disk.
Seleziona le Dimensioni del disco di avvio dall'elenco a discesa. Il valore predefinito è
200GB.
Per un confronto tra le opzioni di archiviazione e i prezzi dei dischi, vedi Opzioni di archiviazione.
(Facoltativo) Configura le opzioni di networking:
I nuovi portali vengono sottoposti al provisioning con un indirizzo IP predefinito per la connessione all'istanza Cloud SQL.
(Facoltativo) Seleziona la casella di controllo per configurare HTTPS sul nuovo portale utilizzando un dominio nip.io.
nip.io è un servizio di terze parti che può fornire un DNS jolly per un indirizzo IP.
Se vuoi utilizzare nip.io per lo sviluppo e il test, puoi modificare il dominio nella
configurazione del bilanciatore del carico prima dell'utilizzo in produzione. Per un esempio dei passaggi richiesti, consulta Utilizzo di un
dominio di test.
(Facoltativo) Configura Cloud Logging e Monitoring:
Cloud Logging e Cloud Monitoring sono abilitati per impostazione predefinita per i nuovi deployment di Apigee Developer Portal Kickstart.
Per disattivare un servizio cloud, deseleziona la casella corrispondente.
(Facoltativo) Configura le opzioni di crittografia:
Per impostazione predefinita, Apigee Developer Portal Kickstart utilizza
chiavi di crittografia gestite da Google
per proteggere l'accesso all'istanza Cloud SQL.
Per utilizzare una chiave di crittografia gestita dal cliente (CMEK) configurata per proteggere l'accesso a Cloud SQL, inserisci il nome risorsa della chiave di crittografia
nel campo di testo.
Fai clic su Esegui il deployment.
Congratulazioni, hai eseguito correttamente il deployment di Apigee Developer Portal Kickstart.
Visualizzare il deployment del portale
Per visualizzare i dettagli del deployment del portale:
Nella pagina di avvio rapido del portale per sviluppatori di Apigee, fai clic su Visualizza deployment precedenti.
Verrà visualizzata la dashboard di Deployment Manager.
Per visualizzare i dettagli di un determinato deployment del portale, seleziona il deployment del portale che ti interessa dall'elenco. La pagina
dei dettagli consiglia i passaggi successivi, fornisce link a documentazione aggiuntiva e link e ID per
i servizi cloud di cui è stato eseguito il provisioning, tra cui:
Gruppo di istanze
Istanza Cloud SQL
Istanza Filestore
Regola firewall
Bilanciatore del carico
Per ulteriori informazioni sulla gestione, l'aggiornamento e l'eliminazione dei deployment, consulta la documentazione di
Deployment Manager.
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa guida rapida, puoi eliminare la tua implementazione. Puoi anche
eliminare il progetto Google Cloud utilizzato per questo tutorial.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
