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 área de trabalho. Como esse servidor Git é alojado por si em git.<your-workspace>.plaid.cloud e a sessão já está iniciada através do início de sessão normal do PlaidCloud, o formulário da ligação é muito mais simples do que o de um fornecedor Git externo: não há URL do servidor a introduzir nem nome de utilizador, token ou chave SSH a gerir.
Quando utilizar
Seção intitulada “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, para que um push para um ramo recompile e volte a implementar 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. Essas mantêm o formulário completo, com um URL do servidor, autenticação por utilizador/token ou SSO e os separadores SSL e SSH.
Criar uma ligação PlaidCloud Git
Seção intitulada “Criar uma ligação PlaidCloud Git”- Abra Tools > Connections
- Clique em
New Connectione escolha PlaidCloud Git no menu - 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
Refreshpara listar os repositórios que a sua área de trabalho consegue alcançar e escolha um (por exemplo, o repositórioudfsouapps). Escolhe a partir da lista, em vez de escrever o caminho. - Ramo predefinido — escolha o ramo a ler por predefinição, a partir da lista de ramos do repositório selecionado
- Caminho inicial — opcionalmente, navegue pelo repositório e escolha uma pasta para limitar todas as pesquisas de ficheiros a uma subpasta; deixe-o por definir para utilizar todo o repositório
- Defina a Utilização —
Activepara ativar a ligação eRead Onlyse a ligação nunca deva escrever - Defina o Modelo de segurança — quem, na área de trabalho, pode utilizar a ligação
- Clique em
Createpara guardar
É todo o formulário. Ao contrário de um fornecedor Git externo, não há URL do servidor, separador de autenticação nem configuração SSL ou SSH: tudo isso é tratado por si.
Modelo de segurança
Seção intitulada “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 |
|---|---|
| Privada (apenas proprietários) | Apenas os proprietários. |
| Apenas membros específicos | Os proprietários e uma lista explícita de membros. |
| Apenas grupos de segurança específicos | Os proprietários e os membros de grupos de segurança indicados. |
| Todos os membros da área de trabalho | Todos os utilizadores 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 os mecanismos de ligação partilhados.
Quem pode ver os repositórios
Seção intitulada “Quem pode ver os repositórios”Todos os repositórios que o PlaidCloud cria para si podem ser lidos por todos os membros com sessão iniciada na sua área de trabalho. Isto inclui os repositórios por trás das suas aplicações Panel e Dash e os repositórios integrados apps e udfs. Quem não tiver sessão iniciada não os pode ler.
Por esse motivo, os membros podem abrir e voltar a publicar aplicações, e escolher um repositório para uma ligação PlaidCloud Git, sem qualquer configuração por repositório.
Avançado: repositórios privados
Seção intitulada “Avançado: repositórios privados”Um administrador do Git pode tornar um repositório privado na interface do Git. Um repositório privado deixa de estar visível para todos os membros, pelo que:
- Não aparece na lista Repositório das ligações PlaidCloud Git.
- O código de UDF baseado em Git não pode ser lido a partir dele, pelo que uma UDF baseada em Git guardada num repositório privado não é executada.
- Os membros não podem publicar uma aplicação a partir dele.
Para utilizar um repositório privado como origem, crie antes uma ligação Git externa com o seu próprio token de acesso.
Automatizar as compilações de aplicações Panel e Dash a partir do Git gerido
Seção intitulada “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 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.
- Faça push da sua aplicação para um repositório no servidor PlaidCloud Git da sua área de trabalho: um ficheiro
.pyde ponto de entrada (o de Panel chama.servable(); o de Dash expõeserver = app.server) e umrequirements.txtopcional na raiz do repositório ou junto ao 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. - Crie uma ligação PlaidCloud Git cujo Repositório seja esse repositório, seguindo os passos acima.
- Em Aplicações, escolha Novo app > Baseada em servidor ou App 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 voltam a implementar a aplicação
- Ponto de entrada — o ficheiro
.pyque a aplicação deve servir
- 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, numa compilação automatizada de ponta a ponta que nunca sai do PlaidCloud.
Ver também
Seção intitulada “Ver também”- Implementar uma aplicação Panel a partir do PlaidCloud Git — o caminho completo, do repositório a 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 — publicar e recompilar uma aplicação Panel de servidor a partir de um ramo Git.
- PlaidCloud Git — o serviço Git integrado da sua área de trabalho.
- Ligações a repositórios Git — fornecedores Git externos e os respetivos formulários de ligação completos.