Implantar um aplicativo Panel a partir do PlaidCloud Git
Este é o caminho completo do código do aplicativo Panel em sua máquina até uma URL ativa, usando o PlaidCloud Git — o serviço Git gerenciado incluído em seu espaço de trabalho — como origem. Como o PlaidCloud Git é gerenciado, a conexão da qual seu aplicativo é implantado não precisa de URL de servidor, nome de usuário nem token: o PlaidCloud autentica em seu nome.
São cinco etapas:
- Escrever um aplicativo Panel mínimo.
- Colocá-lo em um repositório PlaidCloud Git.
- Criar uma conexão gerenciada com o PlaidCloud Git.
- Publicar um aplicativo de servidor que aponte para o repositório.
- Abrir o aplicativo servido — e ler os logs de compilação se ele não iniciar.
Cada etapa tem um link para o guia mais detalhado sobre aquela parte; esta página reúne tudo em um único caminho.
Antes de começar
Seção intitulada “Antes de começar”- Abra Git em seu espaço de trabalho para confirmar que você consegue acessar o PlaidCloud Git. Por padrão, a organização do seu espaço de trabalho inclui um repositório
apps(e umudfs) — o lugar natural para aplicativos Panel. - Tenha o
gitinstalado localmente se quiser enviar código a partir de sua máquina (você também pode adicionar arquivos na interface web do Git).
1. Escreva um aplicativo Panel mínimo
Seção intitulada “1. Escreva um aplicativo Panel mínimo”Seu aplicativo precisa de um ponto de entrada — um arquivo Python que cria um aplicativo Panel e o marca como .servable() — e, opcionalmente, de um requirements.txt para pacotes extras, na raiz do repositório ou ao lado do ponto de entrada.
apps/├── app.py # entry point — calls .servable()└── requirements.txt # optional; extra dependencies (repo root or next to app.py)Crie o app.py:
import panel as pn
pn.extension()
pn.pane.Markdown("# Hello from PlaidCloud Git 👋\n\nServed straight from your workspace repository.").servable()Esse é um aplicativo completo — a chamada .servable() é o que o PlaidCloud serve. O panel, o bokeh e as bibliotecas cliente do PlaidCloud (plaidcloud-rpc, plaidcloud-utilities) já vêm pré-instalados, portanto liste no requirements.txt apenas os pacotes extras. Para exemplos mais completos, dependências e temas claro/escuro, consulte Criar um aplicativo Panel.
2. Coloque seu aplicativo em um repositório PlaidCloud Git
Seção intitulada “2. Coloque seu aplicativo em um repositório PlaidCloud Git”Use o repositório apps já existente em seu espaço de trabalho ou crie um novo. Em seguida, coloque seu código nele. Os aplicativos que você cria no Panel Studio já são pastas em apps, portanto você os encontrará lá, ao lado dos seus.
Como você entra pelo PlaidCloud, sua conta Git não tem uma senha separada — gere um token de acesso pessoal (seu avatar → Settings → Applications) com a permissão write:repository e use-o como senha quando o Git solicitar. Enviar para apps exige acesso de Contributor; peça a um administrador do espaço de trabalho que adicione você a Git Contributors se a guia Git mostrar você como Viewer. Use o botão de copiar ao lado do endereço de clonagem do repositório na guia Git e, em seguida:
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 pushAnote o caminho do repositório — <org>/apps — em que <org> é o nome da organização do seu espaço de trabalho. Você o informará na próxima etapa. Os detalhes completos de clonagem, commit e push estão em Repositórios.
O token aqui serve apenas para você enviar código. A conexão que você criará a seguir é gerenciada e não precisa de token — não confunda os dois.
3. Crie uma conexão gerenciada com o PlaidCloud Git
Seção intitulada “3. Crie uma conexão gerenciada com o PlaidCloud Git”Uma conexão informa a uma implantação Panel onde está o código dela. No PlaidCloud Git, a conexão é gerenciada — o PlaidCloud fornece o host e as credenciais, então você informa apenas o destino do repositório.
- Abra Tools > Connections, clique em Nova conexão e escolha PlaidCloud Git.
- Dê à conexão um Nome da conta (por exemplo,
Apps Repo). - Defina Repository Path como
<org>/apps— o caminho que você anotou na etapa 2 — e Branch padrão comomain. Deixe Caminho inicial em branco, a menos que seus aplicativos estejam em um subdiretório. - Clique em Criar.
Não há campo de URL do servidor, usuário, senha nem SSL/SSH — o PlaidCloud Git é gerenciado, então a plataforma cuida do host e da autenticação. Para o formulário completo, incluindo o Uso e o Modelo de segurança da conexão (quem no espaço de trabalho pode usá-la), consulte Conexão com o PlaidCloud Git.
Em uma versão mais antiga do espaço de trabalho? Se o formulário ainda mostrar uma URL de servidor ou campos de credenciais, basta deixá-los em branco — a plataforma autentica em seu nome de qualquer forma.
4. Publique o aplicativo de servidor
Seção intitulada “4. Publique o aplicativo de servidor”Agora aponte uma implantação de servidor para essa conexão.
- Abra Aplicativos e escolha Novo app > Baseado em servidor.
- Em Configurações do diretório, defina um Nome do aplicativo e um Slug de URL — o slug é a URL e o nome interno do aplicativo, portanto use letras minúsculas, dígitos e hifens, começando com uma letra, com no máximo 40 caracteres (por exemplo,
hello-panel). - Em Conexão Git e monitor de publicação:
- Conexão Git — a conexão com o PlaidCloud Git que você criou na etapa 3.
- Branch —
main. Os pushes nesse branch recompilam e reimplantam o aplicativo automaticamente. - Ponto de entrada —
app.py.
- Em Tempo de execução, escolha CPU, Memória, Design (FAST para a aparência moderna do PlaidCloud) e a janela de Idle. Marque Permitir acesso público somente se o aplicativo deve ser acessível sem fazer login.
- Clique em Publicar.
Todos os campos desta caixa de diálogo estão descritos em Criar um aplicativo Panel.
5. Abra o aplicativo — e leia os logs se ele não iniciar
Seção intitulada “5. Abra o aplicativo — e leia os logs se ele não iniciar”Depois de publicar, o aplicativo é compilado: o PlaidCloud clona o branch, instala seu requirements.txt (o da raiz do repositório e o da pasta do aplicativo, se existirem) e compila uma imagem de contêiner. O Status dele aparece na lista Aplicativos e é atualizado automaticamente.
- Quando o Status for Pronto, abra o aplicativo em
https://<your-tenant-host>/serve/<slug>/. A primeira solicitação depois de um período de inatividade inicia o aplicativo, exibindo brevemente uma tela de carregamento do PlaidCloud. - Se a compilação falhar, abra o aplicativo e verifique os logs de Compilação — uma dependência ausente ou um erro de importação aparece ali. Consulte Usar um aplicativo Panel para saber o que significa cada status, como ler os logs e como acionar uma recompilação.
A partir daí, cada push no branch da conexão recompila e reimplanta o aplicativo automaticamente — edite o app.py, execute git push e sua alteração entra no ar. (A menos que o aplicativo esteja bloqueado — consulte Bloquear um aplicativo —, caso em que os pushes são ignorados até você desbloqueá-lo.)
Próximas etapas
Seção intitulada “Próximas etapas”- Criar um aplicativo Panel — exemplos mais completos, dependências e temas claro/escuro
- Conexão com o PlaidCloud Git — o formulário completo da conexão, o uso e o modelo de segurança
- Leitura de dados e do usuário conectado — consulte dados do PlaidCloud como a pessoa que está visualizando o aplicativo
- Repositórios — branches, tokens e colaboração no PlaidCloud Git