Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Aprenda a criar uma estação de trabalho com o Cloud Workstations.
Uma estação de trabalho é um ambiente de desenvolvimento pré-configurado que administradores
ou equipes de plataforma definem em uma configuração de estação de trabalho. A configuração da estação de trabalho inclui a imagem do contêiner usada por ela. Seus administradores escolhem se querem usar uma das imagens de base pré-configuradas do Cloud Workstations ou fornecer uma referência a uma imagem de contêiner personalizada.
Para seguir as instruções detalhadas desta tarefa diretamente no console do
Google Cloud , clique em Orientação:
Antes de começar a usar o Cloud Workstations, verifique se você tem as permissões necessárias e conclua as etapas de configuração obrigatórias.
Pule esta seção se você já tiver concluído essa configuração.
Sign in to your Google Cloud account. If you're new to
Google Cloud,
create an account to evaluate how our products perform in
real-world scenarios. New customers also get $300 in free credits to
run, test, and deploy workloads.
In the Google Cloud console, on the project selector page,
select or create a Google Cloud project.
Opcional: se você não tiver configurações de estação de trabalho disponíveis no
consoleGoogle Cloud ,
peça ao administrador para criar uma configuração de estação de trabalho para
você ou verifique se você tem um papel de administrador do Cloud Workstations no
projeto para poder criar esses recursos por conta própria.
Para verificar seus papéis do IAM, acesse a página do IAM no console Google Cloud :
O link Criar poderá ser desativado se não houver
configurações de estação de trabalho no projeto ou se você não tiver permissões
para visualizá-las.
Peça ao administrador do Cloud Workstations da organização para criar uma
configuração de estação de trabalho para você.
Aceite o Nome da estação de trabalho padrão.
Se preferir, insira seu próprio nome de recurso para a estação de trabalho, por exemplo, test-workstation.
Siga as convenções de nomenclatura de recursos do Compute Engine e escolha um nome exclusivo no cluster de estações de trabalho.
Clique na seta arrow_drop_downde expansão no campo Configuração e selecione a configuração da estação de trabalho para definir a estação de trabalho.
Clique em Criar
para criar sua estação de trabalho.
Iniciar uma estação de trabalho
Agora que você criou uma estação de trabalho, inicie-a para começar o desenvolvimento:
Clique em Estações de trabalho.
Encontre a estação de trabalho que você criou na lista de estações disponíveis,
marque a caixa de seleção ao lado dela e clique em Iniciar. Isso inicia sua
estação de trabalho e faz a correspondência com a configuração da estação de trabalho principal.
Se for solicitado a iniciar a estação de trabalho, clique em Iniciar para confirmar.
O status muda para Iniciando, e o ícone de status
gira enquanto a operação
de início está em andamento. Pode levar alguns minutos para iniciar sua estação de trabalho.
Quando a estação de trabalho estiver pronta, o status mudará para Em execução e o
ícone de status mudará para uma
marca de seleção check_circle.
Clique em Iniciar. Por padrão, a estação de trabalho se conecta à porta 80.
Opcional: você também pode clicar na seta
arrow_drop_downde expansão
ao lado de Iniciar e selecionar na lista de opções de inicialização:
Conectar-se à porta 80 (padrão)
Conectar ao app da Web na porta
Encaminhamento de portas
Conectar usando SSH
Abrir com o JetBrains Gateway (se você estiver usando um ambiente de desenvolvimento integrado do JetBrains)
O exemplo a seguir mostra a página de boas-vindas do editor de base do Cloud Workstations.
A aparência da página pode variar dependendo de como você define a configuração da estação de trabalho:
Para mais informações sobre como se conectar via SSH, consulte
Suporte a SSH.
Para excluir uma estação de trabalho do console Google Cloud :
No console Google Cloud , acesse
Cloud Workstations>Workstations.
Marque a caixa de seleção ao lado da estação de trabalho que você quer excluir.
Clique no menu de opções more_vertMais e selecione Excluir para excluir a estação de trabalho selecionada.
Se a configuração da estação de trabalho usar discos permanentes e a
política de recuperação
estiver definida para reter discos permanentes depois que você excluir a estação de trabalho, peça ao administrador do Cloud Workstations para excluir manualmente o
disco permanente.
Para mais informações sobre como excluir configurações de estação de trabalho,
clusters de estação de trabalho e projetos do Google Cloud ,
consulte Excluir recursos.
[[["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-08-11 UTC."],[],[],null,["# Create and launch a workstation\n\nLearn how to get started creating a workstation with Cloud Workstations.\n\nA *workstation* is a preconfigured development environment that administrators\nor platform teams define in a *workstation configuration* . The workstation\nconfiguration includes the container image used by the workstation. Your\nadministrators choose whether to use one of the Cloud Workstations\n[preconfigured base images](/workstations/docs/preconfigured-base-images)\nor whether to provide a reference to a\n[customized container image](/workstations/docs/customize-container-images).\n\n*** ** * ** ***\n\nTo follow step-by-step guidance for this task directly in the\nGoogle Cloud console, click **Guide me**:\n\n[Guide me](https://console.cloud.google.com/freetrial?redirectPath=/?journey_id=workstations--set-up--intro&walkthrough_id=workstations--set-up--launch)\n\n*** ** * ** ***\n\n### Before you begin\n\nBefore you begin using Cloud Workstations, be sure that you have the\n[required permissions](/workstations/docs/access-control#enable_required_roles)\nand that you complete these required setup steps.\nYou can skip this section if you've already completed this setup.\n\nSign in to your Google Cloud account. If you're new to Google Cloud, [create an account](https://console.cloud.google.com/freetrial) to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.\n\nIn the Google Cloud console, on the project selector page,\nselect or create a Google Cloud project.\n| **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n[Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n\n\n[Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n\nEnable the Cloud Workstations API.\n\n\n[Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=workstations.googleapis.com) \nIn the Google Cloud console, on the project selector page,\nselect or create a Google Cloud project.\n| **Note**: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.\n\n[Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n\n\n[Verify that billing is enabled for your Google Cloud project](/billing/docs/how-to/verify-billing-enabled#confirm_billing_is_enabled_on_a_project).\n\n\nEnable the Cloud Workstations API.\n\n\n[Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=workstations.googleapis.com)\n1.\n\n\n Enable the Cloud Workstations API.\n\n\n [Enable the API](https://console.cloud.google.com/flows/enableapi?apiid=workstations.googleapis.com)\n2. Optional: If you don't have workstation configurations available in the\n [Google Cloud console](https://console.cloud.google.com/workstations/),\n ask your administrator to create a workstation configuration for\n you, or make sure that you have a Cloud Workstations Admin IAM role on the\n project so that you can create these resources yourself.\n To check your IAM roles, go to the IAM\n page in the Google Cloud console:\n\n [Go to IAM](https://console.cloud.google.com/iam-admin/iam)\n\nCreate a workstation\n--------------------\n\nTo create a workstation, follow these steps:\n\n\u003cbr /\u003e\n\n1. In the Google Cloud console, navigate to the\n **Cloud Workstations** \\\u003e **Workstations**\n page.\n\n\n [Go to Workstations](https://console.cloud.google.com/workstations/list)\n\n \u003cbr /\u003e\n\n2. Click add_box**Create**.\n\n The **Create** link might be disabled if there aren't any\n workstation configurations in the project or if you don't have permissions\n to view them.\n Ask your organization's Cloud Workstations Admin to create a\n workstation configuration for you.\n\n3. Accept the default workstation **Name**.\n\n If you prefer, you can enter your own resource name for your\n workstation---for example, `test-workstation`.\n Follow the Compute Engine resource\n [naming conventions](/compute/docs/naming-resources)\n and choose a name that is unique within the workstation cluster.\n\n4. Click the arrow_drop_downexpander\n arrow in the **Configuration** field and select the\n workstation configuration to define your workstation.\n\n5. Click **Create**\n to create your workstation.\n\nLaunch a workstation\n--------------------\n\nNow that you have created a workstation, you can start it and then launch it to begin development:\n\n\u003cbr /\u003e\n\n1. Click **Workstations**.\n2. Find the workstation that you created in the list of available workstations, select the checkbox beside it, and then click **Start**. This starts your workstation, and matches it to the parent workstation configuration.\n3. If prompted to start your workstation, click **Start** to confirm. The status changes to **Starting** and the status icon refreshspins while the start operation is in progress. It might take a few minutes to start your workstation.\n4. When your workstation is ready, the status changes to **Running** and the status icon changes to a check_circle checkmark.\n5. Click **Launch** . The workstation connects to port `80` by default.\n\n\n Optional: You can also click the\n arrow_drop_downexpander\n arrow next to **Launch** and select from the list of launch options:\n - **Connect to port 80** (default)\n - **Connect to web app on port**\n - **Port forwarding**\n - **Connect using SSH**\n - **Launch with JetBrains Gateway** (if you are using a JetBrains IDE)\n6. The following example shows the welcome page for the Cloud Workstations\n [base editor](/workstations/docs/base-editor-overview).\n Your page might look different, depending on how you define your\n workstation configuration:\n\n For more information about connecting through SSH, see\n [SSH support](/workstations/docs/ssh-support).\n\n For more information about connecting to web apps running on your\n workstation, see\n [Access HTTP servers running on a workstation](/workstations/docs/access-http-servers-running-on-workstations).\n\nClean up\n--------\n\nTo delete a workstation from the Google Cloud console:\n\n1. In the Google Cloud console, go to **Cloud Workstations** \\\u003e **Workstations**.\n2. Select the checkbox beside the workstation that you want to delete.\n3. Click themore_vert**More** options menu and select **Delete** to delete the selected workstation.\n\nIf your workstation configuration uses persistent disks and the\n[reclaim policy](/workstations/docs/reference/rest/v1/projects.locations.workstationClusters.workstationConfigs#reclaimpolicy)\nis set to retain persistent disks after you delete the workstation, be sure to\nremind your Cloud Workstations Admin to manually delete the\npersistent disk for you.\n\n\nFor more about deleting workstation configurations,\nworkstation clusters, and Google Cloud projects,\nsee [Delete resources](/workstations/docs/delete-resources).\n\nWhat's next\n-----------\n\n- Use the\n [Cloud Workstations base editor](/workstations/docs/base-editor-overview).\n\n- Learn more about configuring additional options in your\n [workstation configuration](/workstations/docs/create-configuration).\n\n- Customize your\n [workstation configuration](/workstations/docs/customize-development-environment)\n through the API.\n\n- Create [customized container images](/workstations/docs/customize-container-images)\n that extend the\n [preconfigured base images](/workstations/docs/preconfigured-base-images)\n provided by Cloud Workstations."]]
