Implantar um aplicativo Dash a partir do PlaidCloud Git

Este é o caminho completo do código do aplicativo Dash na sua máquina até uma URL ativa, usando o PlaidCloud Git — o serviço Git gerenciado incorporado ao seu espaço de trabalho — como origem. Como o PlaidCloud Git é gerenciado, a conexão a partir da qual seu aplicativo é implantado não precisa de URL do servidor, nome de usuário nem token: o PlaidCloud se autentica em seu nome.

São cinco etapas:

Escrever um aplicativo Dash mínimo.
Colocá-lo em um repositório PlaidCloud Git.
Criar uma conexão PlaidCloud Git gerenciada.
Publicar um aplicativo Dash que aponte para o repositório.
Abrir o aplicativo servido — e ler os logs de compilação se ele não iniciar.

Este passo a passo é quase idêntico a Implantar um aplicativo Panel a partir do PlaidCloud Git — ambos são aplicativos Python do lado do servidor, criados a partir do Git e servidos da mesma forma. A diferença está no código do aplicativo em si e em um campo da caixa de diálogo de publicação.

Antes de começar

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

1. Escreva um aplicativo Dash mínimo

Seu aplicativo precisa de um ponto de entrada — um arquivo Python que cria um aplicativo Dash e expõe seu servidor Flask — e, opcionalmente, de um requirements.txt para pacotes extras, na raiz do repositório ou ao lado do seu ponto de entrada.

apps/
├── app.py            # entry point — exposes `server`
└── requirements.txt  # optional; extra dependencies (repo root or next to app.py)

Crie o app.py:

import plaidcloud_dash as pcd
from dash import Dash, Input, Output, html

app = Dash(__name__)  # picks up DASH_URL_BASE_PATHNAME from the platform automatically
server = app.server   # the platform imports this and wires per-user sign-in for you

app.layout = html.Div(
    [
        html.H1("Hello from PlaidCloud Git"),
        html.P(id="whoami"),
        html.Button("Who am I?", id="whoami-btn", n_clicks=0),
    ]
)


@app.callback(Output("whoami", "children"), Input("whoami-btn", "n_clicks"))
def _whoami(n_clicks):
    if not n_clicks:
        return ""
    return f"Signed in as {pcd.current_user()!r}"


if __name__ == "__main__":
    app.run(debug=True)

Esse é um aplicativo completo. dash, plotly, dash-mantine-components, dash-ag-grid e as bibliotecas cliente do PlaidCloud (plaidcloud-rpc, plaidcloud-utilities) já vêm pré-instalados, portanto liste no requirements.txt apenas os pacotes extras. Não passe requests_pathname_prefix nem url_base_pathname para Dash(__name__) — a plataforma define o prefixo da URL automaticamente por meio de DASH_URL_BASE_PATHNAME, e definir ambos gera um erro de configuração na inicialização. Para o contrato completo do aplicativo e os auxiliares de acesso a dados, consulte o contrato do aplicativo e Leitura de dados e do usuário conectado em um aplicativo Dash.

2. Coloque seu aplicativo em um repositório PlaidCloud Git

Use o repositório apps existente do seu espaço de trabalho ou crie um novo. Depois, coloque seu código nele.

Como você faz logon pelo PlaidCloud, sua conta Git não tem uma senha separada — gere um token de acesso pessoal (seu avatar → Settings → Applications) com os escopos de leitura e gravação do repositório e use-o como senha quando o Git solicitar. Copie a URL de clone HTTPS do repositório no botão Código e, em seguida:

git clone https://<your-git-host>/<org>/apps.git
cd apps
# add app.py (and requirements.txt), then:
git add app.py requirements.txt
git commit -m "Add hello dash 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 clone, 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 PlaidCloud Git gerenciada

Uma conexão informa a uma implantação Dash onde seu código está. 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. É o mesmo tipo de conexão que um aplicativo Panel de servidor usa.

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 como main. Deixe Caminho inicial em branco, a menos que seus aplicativos fiquem 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 PlaidCloud Git.

4. Publique o aplicativo Dash

Agora aponte uma implantação Dash para essa conexão.

Abra Meus aplicativos Panel e clique em Novo aplicativo Dash.
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; por isso, use letras minúsculas, dígitos e hifens, começando com uma letra, com no máximo 40 caracteres (por exemplo, hello-dash). Um Memorando opcional descreve o aplicativo.
Em Conexão Git e monitor de publicação:
- Conexão Git — a conexão PlaidCloud Git que você criou na etapa 3.
- Branch — main. Os pushes para esse branch recriam e reimplantam o aplicativo automaticamente.
- Ponto de entrada — app.py.
Em Tempo de execução, escolha a CPU, a Memória e a janela de Inatividade (minutos). Marque Permitir acesso público somente se o aplicativo deve ser acessível sem logon. Não há configuração de Design — essa é uma opção específica do Panel.
Em Avançado (exibição incorporada) — opcional. Deixe vazio, a menos que você esteja incorporando o aplicativo em outro site.
Clique em Publicar.

5. Abra o aplicativo — e leia os logs se ele não iniciar

Depois que você publica, o aplicativo é compilado: o PlaidCloud clona o branch, instala o seu requirements.txt e cria uma imagem de contêiner a partir da imagem platform-dash-base. O Status dele aparece na lista Meus aplicativos Panel 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 o reativa, exibindo uma breve tela de carregamento do PlaidCloud enquanto isso acontece.
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 Dash para saber o que cada status significa, como ler os logs e como acionar uma recompilação.

A partir daí, todo push para o branch da conexão recria 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; nesse caso, os pushes são ignorados até você desbloqueá-lo — consulte Usar um aplicativo Dash.)

Próximas etapas

Leitura de dados e do usuário conectado em um aplicativo Dash — consulte dados do PlaidCloud como a pessoa que está visualizando o aplicativo.
Usar um aplicativo Dash — status da compilação, logs, bloqueio e remoção do aplicativo.
Conexão PlaidCloud Git — o formulário completo da conexão, uso e modelo de segurança.
Repositórios — branches, tokens e colaboração no PlaidCloud Git.