Criar um novo aplicativo a partir de um exemplo personalizado 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.
Um repositório de amostra é um repositório Git que contém amostras personalizadas que podem ser usadas
para desenvolver aplicativos. Depois de
configurar seu repositório de amostra
(ou um que já esteja configurado para você), é possível começar a criar aplicativos com essas
amostras.
Também é possível importar o repositório de amostra personalizada do Cloud Code para testar a experiência de amostra personalizada. Para entender melhor como os repositórios de amostra
personalizados são configurados, recomendamos que você tente bifurcar o repositório
e modificar a estrutura e o conteúdo dele antes de importá-lo. Para fazer isso,
crie novas amostras no repositório ou modifique o código-fonte para criar
suas próprias versões dos apps de amostra personalizados Hello World ou Kubernetes.
Antes de começar
Verifique se a versão 2.25.0 ou mais recente do Git está instalada na máquina local.
Para seguir as instruções da tarefa diretamente no editor do
Cloud Shell, clique em Orientação:
Como criar o app a partir de uma amostra importada
Para criar um novo aplicativo usando uma amostra do repositório de amostra:
Copie o URL do Git do repositório de amostra que você quer usar. Se você estiver
usando um repositório Git hospedado na máquina local, o sufixo .git
será omitido e o URL terá o formato /path/to/repo.
Na barra de status do Cloud Code, clique no nome do projeto ativo.
No menu "Escolha rápida" que aparece, selecione Novo aplicativo.
Quando você receber uma solicitação para o tipo de amostra a ser usado, selecione Aplicativo
personalizado.
Clique em Import Sample from Repo.
Quando solicitado, insira o URL do Git que você copiou anteriormente.
O URL neste exemplo usa o formato HTTPS do GitHub: https://github.com/username/repo-name.git.
Dica para solução de problemas:se você tiver problemas com a autenticação do Git,
verifique se a extensão Git integrada do VS Code está ativada (pesquise por
@builtin git) e se a configuração Git: Terminal Authentication nas
Configurações do usuário está marcada.
Para usar a versão mais recente dos seus exemplos no Cloud Code, clique em
refreshRefresh Templates.
Verifique a janela de terminal no ambiente de desenvolvimento integrado para confirmar se o repositório foi
clonado.
A ramificação padrão do repositório é usada automaticamente. Para usar outra ramificação:
Edite a ramificação em uso ou o URL do repositório no arquivo settings.json
em cloudcode.customApplications.
Clique em Custom Application.
Clique em
AtualizarAtualizar.
Se o repositório não foi clonado com êxito,
você pode usar a opção "Gerenciar repositórios" para atualizar os detalhes do repositório de amostra
com um URL e/ou ramificação válido do Git.
Na lista atualizada de amostras, selecione a amostra personalizada.
Insira o nome e o local do projeto.
Clique em Criar novo aplicativo.
O Cloud Code cria seu app usando a amostra escolhida e o abre
para uso.
Receber suporte
Acesse o GitHub para enviar feedback e informar problemas ou o Stack Overflow (ambos em inglês) para fazer perguntas.
[[["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\u003eA sample repository in Git contains custom samples for developing applications, and can be set up or imported for use.\u003c/p\u003e\n"],["\u003cp\u003eYou can try the custom sample experience by importing the Cloud Code custom sample repository, and it's recommended to fork and modify it to understand its setup.\u003c/p\u003e\n"],["\u003cp\u003eTo create a new application from a sample repository, you need the Git URL of the repository, which should preferably be an HTTPS URL.\u003c/p\u003e\n"],["\u003cp\u003eAfter entering the Git URL into the application, you can refresh the templates, confirm the cloning in the terminal, and then select the custom sample to use.\u003c/p\u003e\n"],["\u003cp\u003eThe steps are provided to guide you on how to address issues with Git authentication, how to use different branches, and where you can find support or submit feedback.\u003c/p\u003e\n"]]],[],null,["# Create a new application from a custom sample in Cloud Code for VS Code\n\nA sample repository is a Git repository that contains custom samples you can use\nto develop applications. After you've\n[set up your sample repository](/code/docs/vscode/set-up-sample-repo)\n(or one has been set up for you), you can start creating applications with these\nsamples.\n\nAlternatively, you can import the\n[Cloud Code custom sample sample repository](https://github.com/GoogleCloudPlatform/cloud-code-custom-samples-example/)\nto try the custom sample experience. To better understand how custom sample\nrepositories are set up, it is recommended that you try forking the repository\nand modifying its structure and content before importing it. You can do this by\ncreating new samples in the repository or modifying the source code to create\nyour own versions of the Hello World or Kubernetes Custom Sample apps.\n\nBefore you begin\n----------------\n\nMake sure that Git version 2.25.0 or later is installed on your local machine.\n\n*** ** * ** ***\n\nTo follow step-by-step guidance for this task directly in the\nCloud Shell Editor, click **Guide me**:\n\n[Guide me](https://ide.cloud.google.com/?walkthrough_tutorial_id=cloud_code_custom_samples)\n\n*** ** * ** ***\n\nCreating your app from an imported sample\n-----------------------------------------\n\nTo create a new application using a sample from your sample repository:\n\n1. Copy the Git URL of the sample repository that you'd like to use. If you're\n using a Git repository hosted live on your local machine, the `.git` suffix\n is omitted and the URL is of the form `/path/to/repo`.\n\n | **Note:** Using an **HTTPS** Git URL is recommended. To use a SSH URL, you'll need to generate and configure SSH keys. For more information, see the documentation for your Git repository hosting service. For example, [GitHub](https://docs.github.com/en/github/authenticating-to-github/connecting-to-github-with-ssh), [Bitbucket](https://support.atlassian.com/bitbucket-cloud/docs/set-up-an-ssh-key/), and [GitLab](https://docs.gitlab.com/ee/user/ssh/).\n2. In the Cloud Code status bar, click the active project name.\n\n3. In the Quick Pick menu that appears, select **New Application**.\n\n4. When you're prompted for the type of sample to use, select **Custom\n application**.\n\n5. Click **Import Sample from Repo**.\n\n6. When you're prompted for the URL, enter the Git URL you copied earlier.\n\n The URL in this example uses the HTTPS GitHub format: `https://github.com/username/repo-name.git`.\n\n **Troubleshooting tip:** If you're having trouble with Git authentication,\n check to see that VS Code's built-in Git extension is enabled (search for\n `@builtin git`) and that the `Git: Terminal Authentication` setting in your\n User settings is checked.\n7. To use the latest version of your samples in Cloud Code, click\n refresh\n **Refresh Templates**.\n\n8. Check the terminal window in your IDE to confirm that your repository has been\n cloned successfully.\n\n The repository's default branch is automatically used. To use another branch:\n 1. Edit the branch in use or the repository URL in your `settings.json` file under `cloudcode.customApplications`.\n 2. Click **Custom Application**.\n 3. Click refresh **Refresh**.\n\n If your repository wasn't cloned successfully,\n you can use the Manage Repositories option to update your sample repository\n details with a valid Git URL and/or branch.\n9. From the updated list of samples, select your custom sample.\n\n10. Enter your project name and location.\n\n11. Click **Create New Application**.\n\n Cloud Code creates your app using your chosen sample and opens\n your app for use.\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)."]]
