Esta página descreve como iniciar a solução Apigee Developer Portal Kickstart a partir do Cloud Marketplace
com as opções de configuração predefinidas.
Em muitos casos, existem várias opções de personalização do portal para se adequarem às suas necessidades de escalabilidade, segurança ou monitorização. Consulte o artigo
Personalize a solução Apigee Developer Portal Kickstart no Cloud Marketplace para ver opções de personalização específicas
a ter em conta antes de implementar o seu portal.
Antes de começar
Este tutorial destina-se a familiarizar-se com os passos necessários para uma configuração predefinida do portal.
Antes de implementar um portal para testes ou utilização em produção, consulte o artigo
Personalize a solução Kickstart do Apigee Developer Portal no Cloud Marketplace para ver os passos de configuração pré-requisitos necessários para as seguintes tarefas:
Lançamento de um novo Apigee Developer Portal Kickstart
Siga os passos abaixo para configurar e implementar a solução Apigee Developer Portal Kickstart a partir do Cloud Marketplace:
No Google Cloud console, aceda à
página do Cloud Marketplace e selecione a solução Apigee Developer Portal Kickstart.
Clique em Iniciar.
Configure a nova implementação do portal do programador do Apigee.
Introduza o Nome da implementação. Por exemplo, portal-dev. O nome da sua implementação:
Não deve exceder 10 carateres.
Corresponde à expressão regular [a-z]([-a-z0-9]*[a-z0-9])?. Isto significa que o primeiro caráter
tem de ser uma letra minúscula e todos os carateres seguintes têm de ser hífenes, letras minúsculas
ou dígitos, exceto o último caráter, que não pode ser um hífen.
Selecione a zona preferencial para a sua implementação na lista pendente. Para ver mais
detalhes sobre os recursos do Compute Engine disponíveis em várias zonas, consulte o artigo Regiões e zonas.
Selecione o Tipo de máquina para a instância do Compute Engine na lista pendente.
O valor predefinido é 1vCPU.
Opcional: clique em Personalizar para alterar o Tipo de máquina selecionado,
Núcleos e Memória para
a instância do Compute Engine.
Crie uma nova conta de serviço ou selecione uma conta de serviço existente
para as instâncias do Compute Engine na sua implementação. A conta de serviço é usada pelo Compute Engine para aceder a outras APIs Google.
Para criar uma nova conta de serviço, faculte as seguintes informações:
Nome da conta de serviço: este identificador exclusivo aparece no endereço de email da conta de serviço aprovisionado durante a criação. Por exemplo, sa-name@project-id.iam.gserviceaccount.com.
ID da conta de serviço: o ID tem de ter entre 6 e 30 carateres e pode
conter carateres alfanuméricos em minúsculas e traços.
Descrição da conta de serviço: uma breve descrição da conta de serviço
Para selecionar uma conta de serviço existente, selecione uma conta de serviço na lista pendente
de contas de serviço disponíveis no seu projeto com as funções corretas.
Opcional: configure as opções do disco de arranque:
Selecione o Tipo de disco de arranque na lista pendente. O valor predefinido é
Standard Persistent Disk.
Selecione o Tamanho do disco de arranque na lista pendente. O valor predefinido é
200GB.
Consulte as Opções de armazenamento para uma comparação
das opções de armazenamento e dos preços dos discos.
Opcional: configure as opções de rede:
Os novos portais são aprovisionados com um endereço IP predefinido para estabelecer ligação à instância do Cloud SQL.
Opcionalmente, selecione a caixa de verificação para configurar o HTTPS no novo portal através de um domínio nip.io.
O nip.io é um serviço de terceiros que pode fornecer um DNS com carateres universais para um endereço IP.
Se quiser usar nip.io para desenvolvimento e testes, pode modificar o domínio na configuração do balanceador de carga antes da utilização em produção. Consulte o artigo Usar um domínio de teste para ver um exemplo dos passos necessários.
Opcional: configure o Cloud Logging e a monitorização:
O Cloud Logging e o Cloud Monitoring estão ativados por predefinição para novas implementações do Apigee Developer Portal Kickstart.
Para desativar qualquer um dos serviços na nuvem, desmarque a caixa correspondente.
Para usar uma chave de encriptação gerida pelo cliente (CMEK) configurada para proteger o acesso ao Cloud SQL, introduza o nome do recurso da chave de encriptação
no campo de texto.
Clique em Implementar.
Parabéns, implementou com êxito um Apigee Developer Portal Kickstart!
Ver a implementação do portal
Para ver os detalhes da implementação do portal:
Na página de arranque do portal do programador do Apigee, clique em Ver implementações anteriores.
Esta ação encaminha para o painel de controlo do Deployment Manager.
Para ver os detalhes de uma determinada implementação do portal, selecione a implementação do portal pretendida na lista. A página de detalhes
recomenda os passos seguintes, inclui um link para documentação adicional e fornece links e IDs para
serviços na nuvem aprovisionados, incluindo o seguinte:
Grupo de instâncias
Instância do Cloud SQL
Instância do Filestore
Regra de firewall
Balanceador de carga
Para mais informações sobre a gestão, a atualização e a eliminação de implementações, consulte a documentação do
Deployment Manager.
Limpar
Para evitar incorrer em custos na sua conta do Google Cloud pelos recursos usados neste início rápido,
pode eliminar a sua implementação. Também pode
eliminar o projeto do Google Cloud usado para este tutorial.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
