Ir al contenido
PlaidCloud

Conexión de PlaidCloud Git

Una conexión de PlaidCloud Git apunta un flujo de trabajo, o la compilación de una aplicación Panel de servidor, a un repositorio del servidor Git administrado de su propio espacio de trabajo. Como ese servidor Git se aloja para usted en git.<your-workspace>.plaid.cloud y usted ya ha iniciado sesión con su inicio de sesión normal de PlaidCloud, el formulario de la conexión es mucho más sencillo que el de un proveedor de Git externo: no hay URL de servidor que escribir ni nombre de usuario, token o clave SSH que administrar.

Cuándo usarla

Sección titulada «Cuándo usarla»

Recurra a una conexión de PlaidCloud Git siempre que el repositorio que desea leer resida en PlaidCloud Git, el servicio Git integrado de su espacio de trabajo, en lugar de en un host externo. El uso más habitual es automatizar las compilaciones de aplicaciones Panel de servidor o aplicaciones de Dash desde un repositorio administrado, de modo que un push a una rama recompile y vuelva a implementar la aplicación sin una cuenta externa de GitHub ni un token de acceso personal de por medio.

Para un repositorio alojado en un servicio externo (GitHub, GitLab, Bitbucket, Forgejo o Gitea), use en su lugar una conexión de Git externa. Esas conservan el formulario completo con una URL del servidor, autenticación por usuario/token o SSO, y pestañas SSL y SSH.

Crear una conexión de PlaidCloud Git

Sección titulada «Crear una conexión de PlaidCloud Git»
  1. Abra Tools > Connections
  2. Haga clic en New Connection y elija PlaidCloud Git en el menú
  3. Complete el formulario simplificado:
    • Nombre de la cuenta: un nombre para mostrar de la conexión
    • Nota: una nota opcional sobre para qué sirve la conexión
    • Repositorio: haga clic en Refresh para listar los repositorios a los que puede acceder su espacio de trabajo y luego elija uno (por ejemplo, su repositorio udfs o apps). Lo elige de la lista en lugar de escribir la ruta.
    • Rama predeterminada: elija la rama que se leerá de forma predeterminada entre las ramas del repositorio que seleccionó
    • Ruta de inicio: opcionalmente, explore el repositorio y elija una carpeta para limitar cada búsqueda de archivos a una subcarpeta; déjela sin definir para usar todo el repositorio
  4. Establezca el Uso: Active para habilitar la conexión y Read Only si la conexión nunca debe escribir
  5. Establezca el Modelo de seguridad: quién en el espacio de trabajo puede usar la conexión
  6. Haga clic en Create para guardar

Ese es todo el formulario. A diferencia de un proveedor de Git externo, no hay URL del servidor, ni pestaña de autenticación, ni configuración de SSL o SSH: todo eso se gestiona por usted.

Modelo de seguridad

Sección titulada «Modelo de seguridad»

El Security Model controla quién en el espacio de trabajo puede usar la conexión:

Opción Quién puede usar la conexión
Privado (solo propietarios) Solo los propietarios.
Solo miembros específicos Los propietarios más una lista explícita de miembros.
Solo grupos de seguridad específicos Los propietarios más los miembros de los grupos de seguridad indicados.
Todos los miembros del espacio de trabajo Todos los usuarios del espacio de trabajo.

Para Specific Members Only o Specific Security Groups Only, conceda el acceso desde el menú Actions de la lista tras guardar. Consulte Crear y administrar una conexión para conocer la mecánica compartida de las conexiones.

Automatizar las compilaciones de aplicaciones Panel y de Dash desde Git administrado

Sección titulada «Automatizar las compilaciones de aplicaciones Panel y de Dash desde Git administrado»

Una aplicación Panel de servidor o una aplicación de Dash se compila desde una rama de Git y se recompila automáticamente con cada push a esa rama. Apuntarla a una conexión de PlaidCloud Git mantiene todo el ciclo dentro de su espacio de trabajo: sin host externo y sin un token de acceso personal que mantener vigente.

  1. Haga push de su aplicación a un repositorio del servidor PlaidCloud Git de su espacio de trabajo: un archivo .py de punto de entrada (el de Panel llama a .servable(); el de Dash expone server = app.server) y un requirements.txt opcional en la raíz del repositorio o junto a su punto de entrada. Consulte Crear una aplicación Panel o Implementar una aplicación de Dash desde PlaidCloud Git para conocer la estructura del repositorio.
  2. Cree una conexión de PlaidCloud Git cuyo Repositorio sea ese repositorio, siguiendo los pasos anteriores.
  3. En Mis aplicaciones Panel, haga clic en Nueva aplicación de servidor o Nueva aplicación Dash y, en Conexión de Git y observador de publicación:
    • Conexión de Git: elija la conexión de PlaidCloud Git que acaba de crear
    • Rama: la rama desde la que compilar; los push a ella recompilan y vuelven a implementar la aplicación
    • Punto de entrada: el archivo .py que debe servir la aplicación
  4. Termine el cuadro de diálogo de publicación y haga clic en Publicar.

A partir de entonces, cada push a esa rama del servidor Git administrado recompila la aplicación: una compilación automatizada de extremo a extremo que nunca sale de PlaidCloud.

Relacionado

Sección titulada «Relacionado»