Pular para o conteúdo

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:

  1. Escrever um aplicativo Panel mínimo.
  2. Colocá-lo em um repositório PlaidCloud Git.
  3. Criar uma conexão gerenciada com o PlaidCloud Git.
  4. Publicar um aplicativo de servidor que aponte para o repositório.
  5. 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.

  • 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 um udfs) — o lugar natural para aplicativos Panel.
  • Tenha o git instalado localmente se quiser enviar código a partir de sua máquina (você também pode adicionar arquivos na interface web do Git).

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:

Janela do terminal
git clone <clone URL>
cd apps
# add app.py (and requirements.txt), then:
git add app.py requirements.txt
git commit -m "Add hello panel app"
git push

Anote 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.

  1. Abra Tools > Connections, clique em Nova conexão e escolha PlaidCloud Git.
  2. Dê à conexão um Nome da conta (por exemplo, Apps Repo).
  3. Defina Repository Path como <org>/apps — o caminho que você anotou na etapa 2 — e Branch padrão como main. Deixe Caminho inicial em branco, a menos que seus aplicativos estejam em um subdiretório.
  4. 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.

Agora aponte uma implantação de servidor para essa conexão.

  1. Abra Aplicativos e escolha Novo app > Baseado em servidor.
  2. 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).
  3. 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.
  4. 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.
  5. 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.)