Implementar uma aplicação Panel a partir do PlaidCloud Git
Este é o percurso completo desde o código de uma aplicação Panel no seu computador até um URL em direto, utilizando o PlaidCloud Git — o serviço Git gerido integrado na sua área de trabalho — como origem. Como o PlaidCloud Git é gerido, a ligação a partir da qual a sua aplicação é implementada não precisa de URL de servidor, nome de utilizador nem token: o PlaidCloud autentica-se em seu nome.
Há cinco passos:
- Escrever uma aplicação Panel mínima.
- Colocá-la num repositório PlaidCloud Git.
- Criar uma ligação PlaidCloud Git gerida.
- Publicar uma aplicação de servidor que aponta para o repositório.
- Abrir a aplicação disponibilizada — e ler os registos de compilação se não arrancar.
Cada passo remete para o guia mais detalhado dessa parte; esta página une-os num único percurso.
Antes de começar
Seção intitulada “Antes de começar”- Abra Git a partir da sua área de trabalho para confirmar que consegue aceder ao PlaidCloud Git. Por predefinição, a organização da sua área de trabalho inclui um repositório
apps(e umudfs) — o local natural para aplicações Panel. - Tenha o
gitinstalado localmente se pretender fazer push de código a partir do seu computador (também pode adicionar ficheiros na interface web do Git).
1. Escrever uma aplicação Panel mínima
Seção intitulada “1. Escrever uma aplicação Panel mínima”A sua aplicação precisa de um ponto de entrada — um ficheiro Python que cria uma aplicação Panel e a marca com .servable() — e, opcionalmente, de um requirements.txt para pacotes adicionais, na raiz do repositório ou junto ao ponto de entrada.
apps/├── app.py # entry point — calls .servable()└── requirements.txt # optional; extra dependencies (repo root or next to app.py)Crie app.py:
import panel as pn
pn.extension()
pn.pane.Markdown("# Hello from PlaidCloud Git 👋\n\nServed straight from your workspace repository.").servable()É uma aplicação completa — a chamada .servable() é o que o PlaidCloud disponibiliza. panel, bokeh e as bibliotecas cliente do PlaidCloud (plaidcloud-rpc, plaidcloud-utilities) estão pré-instalados, pelo que deve listar em requirements.txt apenas os pacotes adicionais. Para exemplos mais completos, dependências e temas claro/escuro, consulte Criar uma aplicação Panel.
2. Colocar a sua aplicação num repositório PlaidCloud Git
Seção intitulada “2. Colocar a sua aplicação num repositório PlaidCloud Git”Utilize o repositório apps já existente na sua área de trabalho ou crie um novo. Depois, coloque o seu código nele. As aplicações que cria no Panel Studio já são pastas em apps, pelo que as encontrará aí junto à sua.
Como inicia sessão através do PlaidCloud, a sua conta Git não tem uma palavra-passe própria — gere um token de acesso pessoal (o seu avatar → Settings → Applications) com a permissão write:repository e utilize-o como palavra-passe quando o Git a pedir. Fazer push para apps exige acesso de Contributor; peça a um administrador da área de trabalho que o adicione a Git Contributors se o separador Git o mostrar como Leitor. Utilize o botão de copiar junto ao endereço de clonagem do repositório no separador Git e depois:
git clone <clone URL>cd apps# add app.py (and requirements.txt), then:git add app.py requirements.txtgit commit -m "Add hello panel app"git pushTome nota do caminho do repositório — <org>/apps — em que <org> é o nome da organização da sua área de trabalho. Vai introduzir esse caminho no passo seguinte. Os detalhes completos de clonagem, commit e push estão em Repositórios.
O token aqui serve apenas para si fazer push de código. A ligação que cria a seguir é gerida e não precisa de token — não confunda as duas coisas.
3. Criar uma ligação PlaidCloud Git gerida
Seção intitulada “3. Criar uma ligação PlaidCloud Git gerida”Uma ligação indica a uma implementação Panel onde está o seu código. No PlaidCloud Git, a ligação é gerida — o PlaidCloud fornece o anfitrião e as credenciais, pelo que introduz apenas o destino do repositório.
- Abra Tools > Connections, clique em Nova ligação e escolha PlaidCloud Git.
- Dê à ligação um Nome da conta (por exemplo,
Apps Repo). - Defina Repository Path como
<org>/apps— o caminho que anotou no passo 2 — e Ramo predefinido comomain. Deixe Caminho inicial em branco, a menos que as suas aplicações estejam num subdiretório. - Clique em Criar.
Não existe nenhum campo de URL do servidor, utilizador, palavra-passe ou SSL/SSH — o PlaidCloud Git é gerido, pelo que a plataforma trata do anfitrião e da autenticação. Para o formulário completo, incluindo a Utilização e o Modelo de segurança da ligação (quem na área de trabalho a pode utilizar), consulte Ligação PlaidCloud Git.
Está numa versão mais antiga da área de trabalho? Se o formulário ainda mostrar um URL do servidor ou campos de credenciais, deixe-os em branco — a plataforma autentica-se em seu nome de qualquer forma.
4. Publicar a aplicação de servidor
Seção intitulada “4. Publicar a aplicação de servidor”Agora aponte uma implementação de servidor para essa ligação.
- Abra Aplicações e escolha Novo app > Baseada em servidor.
- Em Definições do diretório, defina um Nome da aplicação e um Slug de URL — o slug é o URL e o nome interno da aplicação, pelo que deve usar letras minúsculas, dígitos e hífenes, começando por uma letra, com 40 caracteres ou menos (por exemplo,
hello-panel). - Em Ligação Git e monitor de publicação:
- Ligação Git — a ligação PlaidCloud Git que criou no passo 3.
- Ramo —
main. Os pushes para este ramo recompilam e voltam a implementar a aplicação automaticamente. - Ponto de entrada —
app.py.
- Em Tempo de execução, escolha a CPU, a Memória, o Design (FAST para o aspeto moderno do PlaidCloud) e a janela de Idle. Assinale Permitir acesso público apenas se a aplicação deve ser acessível sem iniciar sessão.
- Clique em Publicar.
Todos os campos desta caixa de diálogo são descritos em Criar uma aplicação Panel.
5. Abrir a aplicação — e ler os registos se não arrancar
Seção intitulada “5. Abrir a aplicação — e ler os registos se não arrancar”Depois de publicar, a aplicação é compilada: o PlaidCloud clona o ramo, instala o seu requirements.txt (o da raiz do repositório e o da pasta da aplicação, se existirem) e cria uma imagem de contentor. O seu Estado é mostrado na lista Aplicações e atualiza-se automaticamente.
- Quando o Estado é Pronta, abra a aplicação em
https://<your-tenant-host>/serve/<slug>/. O primeiro pedido depois de ter estado inativa põe-na a funcionar e apresenta, entretanto, um breve ecrã de carregamento do PlaidCloud. - Se a compilação falhar, abra a aplicação e consulte os registos de Build — uma dependência em falta ou um erro de importação aparece aí. Consulte Utilizar uma aplicação Panel para saber o que significa cada estado, como ler os registos e como desencadear uma recompilação.
A partir daqui, cada push para o ramo da ligação recompila e volta a implementar a aplicação automaticamente — edite app.py, faça git push e a alteração entra em produção. (A menos que a aplicação esteja bloqueada — consulte Bloquear uma aplicação — caso em que os pushes são ignorados até a desbloquear.)
Passos seguintes
Seção intitulada “Passos seguintes”- Criar uma aplicação Panel — exemplos mais completos, dependências e temas claro/escuro
- Ligação PlaidCloud Git — o formulário completo da ligação, a utilização e o modelo de segurança
- Ler dados e o utilizador com sessão iniciada — consulte dados do PlaidCloud como a pessoa que está a ver a aplicação
- Repositórios — ramos, tokens e colaboração no PlaidCloud Git