Um repositório de amostra é um repositório Git que contém amostras personalizadas que você pode usar para desenvolver sua equipe.
Isso significa que, em uma organização ou equipe, é possível configurar repositórios de amostra com o Cloud Code, personalizado para sua organização, para oferecer um conjunto padrão de aplicativos, serviços e configurações de infraestrutura iniciais que outras pessoas pode usar. Isso ajuda a alinhar os novos projetos com os padrões e a pilha técnica preferenciais da sua organização e incentiva as práticas recomendadas no início do ciclo de desenvolvimento.
Um repositório de amostra pode ser um repositório existente de aplicativos de amostra que você já criou ou um novo conjunto de amostras que você gostaria que outras pessoas usassem. Para importar um repositório com o Cloud Code, adicione um arquivo do descritor de amostra ao repositório.
Quando eles estiverem prontos, os repositórios de amostra serão fáceis de compartilhar com sua equipe. o usuário precisará configurar o Cloud Code e o URL do Git do repositório de amostra que será usado. Para repositórios Git particulares, somente membros que tenham acesso ao repositório podem usar as amostras personalizadas subjacentes.
Para ver um exemplo de como um repositório de amostra pode ser configurado, consulte este repositório (em inglês).
Antes de começar
Verifique se o Git versão 2.25.0 ou posterior está instalado na sua máquina local.
Como criar um repositório de amostra
Para usar um repositório existente, pule para Como criar um arquivo de descritor de amostra. Para criar um novo repositório a ser usado como repositório de amostra, siga estas etapas:
Crie um novo repositório Git.
Seu repositório Git pode ser hospedado remotamente ou ativo na máquina local. Este exemplo usa um novo repositório do GitHub: 'custom-sample-repo'.
Adicione diretórios de amostra ao repositório.
Seus diretórios de amostra podem conter qualquer coisa e estar localizados onde você quiser no repositório. Neste exemplo, dois diretórios de amostra, "hello-world" e "kubernetes-custom-sample", foram adicionados a "custom-sample-repo".
É altamente recomendável usar um arquivo readme com instruções sobre como usar melhor as amostras personalizadas.
Crie um arquivo de descritor de amostra.
Um arquivo descritor de amostra fornece informações sobre a amostra para que o Cloud Code crie o aplicativo corretamente. Esse arquivo precisa ter o nome
.cctemplate, estar no diretório raiz e ter o esquema definido na seção esquema de arquivo do descritor de amostra.Teste sua amostra personalizada seguindo as etapas para criar um aplicativo de uma amostra personalizada.
Exemplo de esquema do descritor
| Chave | Descrição | Tipo |
| metadados | Metadados usados pelo Cloud Code para ler. Compatível com o esquema de metadados. | Metadados |
| Modelos | Matriz de amostras contidas em um repositório. Os objetos nessa matriz precisam estar em conformidade com o Esquema de amostra. | Matriz<Sample> |
| nome (optional) | Nome do repositório de amostra. | String |
Exemplo
{
"metadata":{
"version":"1"
},
"name": "My Sample Repository",
"templates":[
{
"path":"/path/to/sample1_location",
"name":"My Sample 1",
"description":"The first sample of its name."
},
{
"path":"/path/to/sample2_location",
"name":"My Sample 2",
"description":"The sequel."
}
]
}
Esquema de amostra
| Chave | Descrição | Tipo |
| caminho | O local da amostra em um repositório. O caminho é relativo à raiz do repositório. |
String |
| nome | Nome de uma amostra. O nome é exibido em um ambiente de desenvolvimento integrado ao selecionar uma amostra para usar como base para um aplicativo. |
String |
| descrição (opcional) | Descrição de uma amostra. A descrição é exibida em um ambiente de desenvolvimento integrado ao selecionar uma amostra para usar como base para um aplicativo. |
String |
Exemplo
{
"path":"path/to/sample1",
"name":"My Sample 1",
"description":"The first sample of its name."
}
Esquema de metadados
| Chave | Descrição | Tipo |
| version | A versão do esquema de amostra a ser usada. A única versão válida é
1.
|
String |
Exemplo
{
"version":"1"
}
Como excluir um repositório de amostra personalizado
Para excluir um repositório de amostra personalizado do Cloud Code:
Navegue até Preferências > Ferramentas > Cloud Code > Amostras personalizadas.
Na tabela Custom Sample Repositories, selecione o URL do repositório que você quer remover e clique em - Remove.
Na caixa de diálogo de confirmação exibida, clique em Remover para excluir o repositório selecionado do Cloud Code.
Como receber suporte
Para enviar um feedback ou informar um problema no ambiente de desenvolvimento integrado do IntelliJ, acesse Tools > Cloud Code > Help / About > Envie feedback ou informe um problema para informar um problema no GitHub ou faça uma pergunta no Stack Overflow.Você também pode participar do canal #cloud-code, que faz parte da comunidade do Google Cloud no Slack.