Armazenar imagens de contêineres no Cloud Code para VS Code
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Para executar ou depurar um aplicativo em um cluster remoto do Kubernetes, é necessário
definir o repositório de imagens do contêiner para seu projeto. Use qualquer provedor de repositório
de imagens, incluindo o Artifact Registry.
Especificar onde as imagens de contêiner são armazenadas
Se você tiver feito login no Google Cloud no seu ambiente de desenvolvimento integrado e tiver um
projeto padrão definido, o Cloud Code usará automaticamente o
repositório de imagens de contêiner padrão
gcr.io/PROJECT_ID, em que
PROJECT_ID faz referência ao seu projeto padrão.
Se você quiser atualizar o repositório de imagens para onde as imagens
do projeto serão enviadas, siga estas instruções:
Abra a paleta de comandos (pressione Ctrl/Cmd+Shift+P) e execute o comando Cloud Code: Run on Kubernetes.
Confirme se você quer usar o contexto do Kubernetes atual para executar o aplicativo (ou alternar para um preferido).
Você vai precisar selecionar um registro de imagem.
Insira o repositório de imagens em que você quer armazenar as imagens.
Consulte a seção formatos comuns de repositório de imagens para conferir exemplos de como especificar onde as imagens de contêiner são armazenadas para alguns registros comuns.
Criação do nome da imagem
O Cloud Code concatena o registro de imagem com o nome da imagem
especificado nos manifestos do Kubernetes para gerar o nome final do repositório de imagens.
[[["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-05 UTC."],[[["\u003cp\u003eTo deploy applications to a remote Kubernetes cluster, you must define the container image repository, which can be any provider, including Artifact Registry.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code automatically uses \u003ccode\u003egcr.io/PROJECT_ID\u003c/code\u003e as the default container image repository if you're logged into Google Cloud in your IDE and have a default project set, unless you are on a local cluster.\u003c/p\u003e\n"],["\u003cp\u003eYou can change the image repository by using the "Cloud Code: Run on Kubernetes" command in the Command Palette and selecting your preferred registry.\u003c/p\u003e\n"],["\u003cp\u003eCloud Code generates the final image repository name by concatenating the image registry with the image name specified in the Kubernetes manifests.\u003c/p\u003e\n"],["\u003cp\u003eThe document provides examples of common image repository formats for Docker Hub, Artifact Registry, AWS ECR, and Azure Container Registry.\u003c/p\u003e\n"]]],[],null,["# Store your container images in Cloud Code for VS Code\n\nTo run or debug an application on a remote Kubernetes cluster, you'll need to\ndefine the container image repository for your project. You can use any image\nrepository provider, including [Artifact Registry](/artifact-registry/docs).\n\nSpecify where container images are stored\n-----------------------------------------\n\nIf you're logged into Google Cloud in your IDE and you have a\ndefault project defined, Cloud Code automatically uses your\ndefault container image repository\n**gcr.io/\u003cvar class=\"readonly\" translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e** , where\n\u003cvar class=\"readonly\" translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e references your default project.\n| **Note:** If you are running on a local cluster like minikube or Docker Desktop, you do not need to specify these configurations.\n\nIf you'd like to update the image repository where the project\nimages are pushed, follow these instructions:\n\n1. Open the Command Palette (press `Ctrl`/`Cmd`+`Shift`+`P`) and then run the **Cloud Code: Run on Kubernetes** command.\n2. Confirm whether to use the current [Kubernetes context](https://kubernetes.io/docs/concepts/configuration/organize-cluster-access-kubeconfig/#context) to run the app in (or switch to a preferred one).\n3. You are prompted to select an image registry.\n4. Enter the image repository you want to store your images in.\n\n If your project has [Artifact Registry API enabled](/artifact-registry/docs/enable-service)\n and at least one [Artifact Registry repository](/artifact-registry/docs/manage-repos),\n you can browse to and select an existing Artifact Registry repository.\n\nSee the [common image repository formats](#image_formats) section for examples\nof how to specify where container images are stored for some common registries.\n\n### Image name creation\n\nCloud Code concatenates the image registry with the image name\nspecified in the Kubernetes manifests to generate the final image repository\nname.\n\nFor more information, see the\n[image registry handling guide](https://skaffold.dev/docs/environment/image-registries).\n\nThis choice is stored in your `cloudcode.kubernetes` launch configuration\n(found in .vscode/launch.json).\n\n\nCloud Code builds your containers, pushes them to the registry,\napplies Kubernetes configurations to the cluster, and waits for the rollout.\n\n### Common image repository formats\n\nHere are examples of how to specify where container images are stored for some\ncommon registries:\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nWhat's next\n-----------\n\n- [Create and configure a GKE cluster](/code/docs/vscode/create-configure-gke-cluster).\n- Learn more about [Artifact Registry](/artifact-registry/docs/overview).\n\nGet Support\n-----------\n\nTo send feedback, report issues on [GitHub](https://github.com/GoogleCloudPlatform/cloud-code-vscode/issues), or ask a question on [Stack Overflow](https://stackoverflow.com/questions/ask?tags=cloud-code-vscode)."]]
