Implementar una aplicación Panel desde PlaidCloud Git

Este es el recorrido completo desde el código de una aplicación Panel en su equipo hasta una URL en vivo, usando PlaidCloud Git, el servicio Git administrado integrado en su espacio de trabajo, como origen. Como PlaidCloud Git es administrado, la conexión desde la que se implementa su aplicación no necesita URL de servidor, nombre de usuario ni token: PlaidCloud se autentica en su nombre.

Son cinco pasos:

Escribir una aplicación Panel mínima.
Colocarla en un repositorio de PlaidCloud Git.
Crear una conexión administrada de PlaidCloud Git.
Publicar una aplicación de servidor que apunte al repositorio.
Abrir la aplicación servida y leer los registros de compilación si no se inicia.

Cada paso enlaza con la guía detallada correspondiente; esta página los une en un solo recorrido.

Antes de empezar

Abra Git desde su espacio de trabajo para confirmar que puede acceder a PlaidCloud Git. De forma predeterminada, la organización de su espacio de trabajo incluye un repositorio apps (y uno udfs), el lugar natural para las aplicaciones Panel.
Tenga git instalado en local si desea hacer push del código desde su equipo (también puede agregar archivos en la interfaz web de Git).

1. Escribir una aplicación Panel mínima

Su aplicación necesita un punto de entrada (un archivo Python que crea una aplicación Panel y la marca como .servable()) y, opcionalmente, un requirements.txt para paquetes adicionales, ya sea en la raíz del repositorio o junto a su punto de entrada.

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

Cree app.py:

import panel as pn

pn.extension()

pn.pane.Markdown("# Hello from PlaidCloud Git 👋\n\nServed straight from your workspace repository.").servable()

Esa es una aplicación completa: la llamada a .servable() es lo que PlaidCloud sirve. panel, bokeh y las bibliotecas cliente de PlaidCloud (plaidcloud-rpc, plaidcloud-utilities) están preinstalados, así que enumere en requirements.txt solo los paquetes adicionales. Para ver ejemplos más completos, dependencias y temas claro/oscuro, consulte Creación de una aplicación Panel.

2. Colocar su aplicación en un repositorio de PlaidCloud Git

Use el repositorio apps existente de su espacio de trabajo, o cree uno nuevo. Luego suba su código a él.

Como inicia sesión a través de PlaidCloud, su cuenta de Git no tiene una contraseña independiente: genere un token de acceso personal (su avatar → Configuración → Applications) con permisos de lectura y escritura en el repositorio, y úselo como contraseña cuando Git se la solicite. Copie la URL de clonación HTTPS del repositorio desde su botón Code y luego:

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 panel app"
git push

Anote la ruta del repositorio, <org>/apps, donde <org> es el nombre de la organización de su espacio de trabajo. La ingresará en el siguiente paso. Los detalles completos de clonación, commit y push están en Repositorios.

El token de aquí es solo para que usted haga push del código. La conexión que creará a continuación es administrada y no necesita token: no confunda ambos.

3. Crear una conexión administrada de PlaidCloud Git

Una conexión le indica a una implementación de Panel dónde se encuentra su código. Para PlaidCloud Git, la conexión es administrada: PlaidCloud proporciona el host y las credenciales, por lo que usted solo ingresa el destino del repositorio.

Abra Tools > Connections, haga clic en Nueva conexión y elija PlaidCloud Git.
Asigne a la conexión un Nombre de la cuenta (por ejemplo, Apps Repo).
Establezca Repository Path como <org>/apps (la ruta que anotó en el paso 2) y Rama predeterminada como main. Deje Ruta de inicio en blanco a menos que sus aplicaciones estén en un subdirectorio.
Haga clic en Crear.

No hay campos de URL del servidor, usuario, contraseña ni SSL/SSH: PlaidCloud Git es administrado, por lo que la plataforma se encarga del host y de la autenticación. Para ver el formulario completo, incluidos el Uso y el Modelo de seguridad de la conexión (quién en el espacio de trabajo puede usarla), consulte Conexión de PlaidCloud Git.

¿Tiene una versión anterior del espacio de trabajo? Si el formulario aún muestra una URL del servidor o campos de credenciales, simplemente déjelos en blanco: la plataforma se autentica en su nombre en cualquier caso.

4. Publicar la aplicación de servidor

Ahora apunte una implementación de servidor a esa conexión.

Abra Mis aplicaciones Panel y haga clic en Nueva aplicación de servidor.
En Configuración del directorio, defina un Nombre de la aplicación y un Slug de URL; el slug es la URL y el nombre interno de la aplicación, así que use letras minúsculas, dígitos y guiones, que empiece con una letra, de 40 caracteres o menos (por ejemplo, hello-panel).
En Conexión de Git y observador de publicación:
- Conexión de Git: la conexión de PlaidCloud Git que creó en el paso 3.
- Rama: main. Los push a esta rama vuelven a compilar y a implementar la aplicación automáticamente.
- Punto de entrada: app.py.
En Tiempo de ejecución, elija la CPU, la Memoria, el Diseño (FAST para el aspecto moderno de PlaidCloud) y la ventana de Inactividad. Marque Permitir acceso público solo si la aplicación debe ser accesible sin iniciar sesión.
Haga clic en Publicar.

Cada campo de este cuadro de diálogo se describe en Creación de una aplicación Panel.

5. Abrir la aplicación y leer los registros si no se inicia

Después de publicar, la aplicación se compila: PlaidCloud clona la rama, instala su requirements.txt (el de la raíz del repositorio y el de la carpeta de su aplicación, si existen) y compila una imagen de contenedor. Su Estado aparece en la lista Mis aplicaciones Panel y se actualiza automáticamente.

Cuando el estado es Lista, abra la aplicación en https://<your-tenant-host>/serve/<slug>/. La primera solicitud después de un período de inactividad la reactiva (~15 segundos).
Si la compilación falla, abra la aplicación y revise sus registros de Crear: una dependencia faltante o un error de importación aparecen allí. Consulte Uso de una aplicación Panel para saber qué significa cada estado, cómo leer los registros y cómo activar una nueva compilación.

A partir de ahora, cada push a la rama de la conexión vuelve a compilar y a implementar la aplicación automáticamente: edite app.py, ejecute git push y su cambio entra en vivo. (A menos que la aplicación esté bloqueada, consulte Bloqueo de una aplicación, en cuyo caso los push se omiten hasta que la desbloquee.)

Siguientes pasos

Creación de una aplicación Panel: ejemplos más completos, dependencias y temas claro/oscuro
Conexión de PlaidCloud Git: el formulario de conexión completo, el uso y el modelo de seguridad
Lectura de datos y usuario con sesión iniciada: consulte los datos de PlaidCloud como la persona que ve la aplicación
Repositorios: ramas, tokens y colaboración en PlaidCloud Git