Pular para o conteúdo

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:

  1. Escrever uma aplicação Panel mínima.
  2. Colocá-la num repositório PlaidCloud Git.
  3. Criar uma ligação PlaidCloud Git gerida.
  4. Publicar uma aplicação de servidor que aponta para o repositório.
  5. 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.

  • 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 um udfs) — o local natural para aplicações Panel.
  • Tenha o git instalado localmente se pretender fazer push de código a partir do seu computador (também pode adicionar ficheiros na interface web do Git).

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:

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

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

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.

  1. Abra Tools > Connections, clique em Nova ligação e escolha PlaidCloud Git.
  2. Dê à ligação um Nome da conta (por exemplo, Apps Repo).
  3. Defina Repository Path como <org>/apps — o caminho que anotou no passo 2 — e Ramo predefinido como main. Deixe Caminho inicial em branco, a menos que as suas aplicações estejam num subdiretório.
  4. 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.

Agora aponte uma implementação de servidor para essa ligação.

  1. Abra Aplicações e escolha Novo app > Baseada em servidor.
  2. 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).
  3. 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.
  4. 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.
  5. 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.)