Ligação PlaidCloud Git

Uma ligação PlaidCloud Git aponta um fluxo de trabalho — ou a compilação de uma aplicação Panel de servidor — para um repositório no servidor Git gerido da sua própria área de trabalho. Como esse servidor Git é alojado por si em git.<your-workspace>.plaid.cloud e já tem sessão iniciada através do seu início de sessão normal no PlaidCloud, o formulário da ligação é muito mais simples do que o de um fornecedor de Git externo: não há URL de servidor a introduzir nem nome de utilizador, token ou chave SSH a gerir.

Nota

Nunca introduz um URL de servidor nem credenciais numa ligação PlaidCloud Git. O servidor Git da sua área de trabalho e o seu acesso a ele são tratados automaticamente a partir do seu início de sessão no PlaidCloud (incluindo SSO) — pelo que não há tokens para criar, guardar ou rodar.

Quando utilizar

Recorra a uma ligação PlaidCloud Git sempre que o repositório que pretende ler esteja no PlaidCloud Git — o serviço Git integrado da sua área de trabalho — e não num anfitrião externo. A utilização mais comum é automatizar as compilações de aplicações Panel de servidor ou aplicações Dash a partir de um repositório gerido, de modo que um push para um ramo recompile e reimplemente a aplicação sem uma conta GitHub externa nem um token de acesso pessoal pelo meio.

Para um repositório alojado num serviço externo — GitHub, GitLab, Bitbucket, Forgejo ou Gitea — utilize antes uma ligação Git externa. Estas mantêm o formulário completo, com um URL do servidor, autenticação por utilizador/token ou SSO, e separadores SSL e SSH.

Criar uma ligação PlaidCloud Git

1. Abra Tools > Connections
2. Clique em New Connection e escolha PlaidCloud Git no menu
3. Preencha o formulário simplificado:
   • Nome da conta — um nome de apresentação para a ligação
   • Memorando — uma nota opcional sobre a finalidade da ligação
   • Repositório — clique em Refresh para listar os repositórios a que a sua área de trabalho consegue aceder e escolha um (por exemplo, o seu repositório udfs ou apps). Escolhe da lista em vez de escrever o caminho.
   • Ramo predefinido — escolha o ramo a ler por omissão a partir da lista de ramos do repositório que selecionou
   • Caminho inicial — opcionalmente, navegue pelo repositório e escolha uma pasta para limitar todas as pesquisas de ficheiros a uma subpasta; deixe por definir para utilizar todo o repositório
4. Defina Utilização — Active para ativar a ligação e Read Only se a ligação nunca deve escrever
5. Defina o Modelo de segurança — quem na área de trabalho pode utilizar a ligação
6. Clique em Create para guardar

Este é todo o formulário. Ao contrário de um fornecedor de Git externo, não há URL do servidor, separador de autenticação nem configuração SSL ou SSH — tudo isso é tratado por si.

Nota

O Repositório, o Ramo predefinido e o Caminho inicial são escolhidos a partir de listas em direto — escolha primeiro um repositório, depois o respetivo ramo e, por fim, navegue até uma pasta — pelo que não há nada que possa escrever mal. Cada lista é lida com o acesso da própria ligação, pelo que, numa ligação PlaidCloud Git, são preenchidas de imediato, sem credenciais a introduzir.

Modelo de segurança

O Security Model controla quem na área de trabalho pode utilizar a ligação:

Opção	Quem pode utilizar a ligação
Privado (apenas proprietários)	Apenas os proprietários.
Apenas membros específicos	Os proprietários mais uma lista explícita de membros.
Apenas grupos de segurança específicos	Os proprietários mais os membros de grupos de segurança indicados.
Todos os membros da área de trabalho	Todas as pessoas da área de trabalho.

Para Specific Members Only ou Specific Security Groups Only, conceda o acesso a partir do menu Actions da lista depois de guardar. Consulte Criar e gerir uma ligação para a mecânica partilhada das ligações.

Automatizar as compilações de aplicações Panel e Dash a partir do Git gerido

Uma aplicação Panel de servidor ou uma aplicação Dash é compilada a partir de um ramo do Git e recompilada automaticamente a cada push para esse ramo. Apontá-la para uma ligação PlaidCloud Git mantém todo o ciclo dentro da sua área de trabalho — sem anfitrião externo e sem um token de acesso pessoal para manter ativo.

1. Faça push da sua aplicação para um repositório no servidor PlaidCloud Git da sua área de trabalho — um ficheiro .py de ponto de entrada (o do Panel chama .servable(); o do Dash expõe server = app.server) e um requirements.txt opcional na raiz do repositório ou junto do ponto de entrada. Consulte Criar uma aplicação Panel ou Implementar uma aplicação Dash a partir do PlaidCloud Git para a estrutura do repositório.
2. Crie uma ligação PlaidCloud Git cujo Repositório seja esse repositório, seguindo os passos acima.
3. Em As minhas aplicações Panel, clique em Nova aplicação de servidor ou Nova aplicação Dash e, em Ligação Git e monitor de publicação:
   • Ligação Git — escolha a ligação PlaidCloud Git que acabou de criar
   • Ramo — o ramo a partir do qual compilar; os pushes para ele recompilam e reimplementam a aplicação
   • Ponto de entrada — o ficheiro .py que a aplicação deve servir
4. Conclua a caixa de diálogo de publicação e clique em Publicar.

A partir daí, cada push para esse ramo no seu servidor Git gerido recompila a aplicação — uma compilação automatizada de ponta a ponta que nunca sai do PlaidCloud.

Relacionado

• Implementar uma aplicação Panel a partir do PlaidCloud Git — o caminho de ponta a ponta do repositório até uma aplicação servida.
• Implementar uma aplicação Dash a partir do PlaidCloud Git — o mesmo caminho para uma aplicação Plotly Dash.
• Criar e gerir uma ligação — o formulário partilhado, os ambientes, os testes e os controlos de acesso.
• Criar uma aplicação Panel — publique e recompile uma aplicação Panel de servidor a partir de um ramo do Git.
• PlaidCloud Git — o serviço Git integrado da sua área de trabalho.
• Ligações a repositórios Git — fornecedores de Git externos e respetivos formulários de ligação completos.