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 por usted en git.<your-workspace>.plaid.cloud y ya ha iniciado sesión con su inicio de sesión normal de PlaidCloud, el formulario de conexión es mucho más sencillo que el de un proveedor de Git externo: no hay que ingresar una URL de servidor ni administrar un nombre de usuario, un token o una clave SSH.
Cuándo usarla
Sección titulada «Cuándo usarla»Use una conexión de PlaidCloud Git siempre que el repositorio que desea leer se encuentre en PlaidCloud Git, el servicio Git integrado de su espacio de trabajo, y no en un host externo. El uso más común 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. Estas conservan el formulario completo con una URL del servidor, autenticación por usuario y token o por SSO, y las pestañas SSL y SSH.
Crear una conexión de PlaidCloud Git
Sección titulada «Crear una conexión de PlaidCloud Git»- Abra Tools > Connections
- Haga clic en
New Connectiony elija PlaidCloud Git en el menú - Complete el formulario simplificado:
- Nombre de la cuenta: un nombre para mostrar de la conexión
- Nota: una nota opcional sobre el propósito de la conexión
- Repositorio: haga clic en
Refreshpara listar los repositorios a los que puede acceder su espacio de trabajo y elija uno (por ejemplo, su repositorioudfsoapps). Lo selecciona de la lista en lugar de escribir la ruta. - Rama predeterminada: elija la rama que se leerá de forma predeterminada de la lista de ramas del repositorio seleccionado
- 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
- Defina Uso:
Activepara habilitar la conexión yRead Onlysi la conexión nunca debe escribir - Defina el Modelo de seguridad: quién del espacio de trabajo puede usar la conexión
- Haga clic en
Createpara guardar
Eso 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»Security Model controla quién del 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 y una lista explícita de miembros. |
| Solo grupos de seguridad específicos | Los propietarios y 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 después de guardar. Consulte Crear y administrar una conexión para conocer los mecanismos comunes de las conexiones.
Quién puede ver los repositorios
Sección titulada «Quién puede ver los repositorios»Todos los repositorios que PlaidCloud crea para usted pueden ser leídos por cualquier miembro de su espacio de trabajo que haya iniciado sesión. Esto incluye los repositorios detrás de sus aplicaciones Panel y Dash y los repositorios integrados apps y udfs. Nadie que no haya iniciado sesión puede leerlos.
Por eso, los miembros pueden abrir y volver a publicar aplicaciones, y elegir un repositorio para una conexión de PlaidCloud Git, sin ninguna configuración por repositorio.
Avanzado: repositorios privados
Sección titulada «Avanzado: repositorios privados»Un administrador de Git puede hacer privado un repositorio en la interfaz de Git. Un repositorio privado deja de ser visible para todos los miembros, por lo que:
- No aparece en la lista Repositorio de las conexiones de PlaidCloud Git.
- No se puede leer de él el código de UDF respaldado por Git, así que una UDF respaldada por Git almacenada en un repositorio privado no se ejecutará.
- Los miembros no pueden publicar una aplicación desde él.
Para usar un repositorio privado como origen, cree en su lugar una conexión de Git externa con su propio token de acceso.
Automatizar las compilaciones de aplicaciones Panel y Dash desde Git administrado
Sección titulada «Automatizar las compilaciones de aplicaciones Panel y 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.
- Haga push de su aplicación a un repositorio del servidor PlaidCloud Git de su espacio de trabajo: un archivo
.pyde punto de entrada (el de Panel llama a.servable(); el de Dash exponeserver = app.server) y unrequirements.txtopcional 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. - Cree una conexión de PlaidCloud Git cuyo Repositorio sea ese repositorio, siguiendo los pasos anteriores.
- En Aplicaciones, elija Nueva aplicación > Basada en servidor o App 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 se compila; los push a ella recompilan y vuelven a implementar la aplicación
- Punto de entrada: el archivo
.pyque debe servir la aplicación
- Termine el cuadro de diálogo de publicación y haga clic en Publicar.
A partir de entonces, cada push a esa rama en su servidor Git administrado recompila la aplicación: una compilación automatizada de extremo a extremo que nunca sale de PlaidCloud.
Temas relacionados
Sección titulada «Temas relacionados»- Implementar una aplicación Panel desde PlaidCloud Git: la ruta completa desde el repositorio hasta una aplicación en servicio.
- Implementar una aplicación de Dash desde PlaidCloud Git: la misma ruta para una aplicación Plotly Dash.
- Crear y administrar una conexión: el formulario común, los entornos, las pruebas y los controles de acceso.
- Crear una aplicación Panel: publique y recompile una aplicación Panel de servidor desde una rama de Git.
- PlaidCloud Git: el servicio Git integrado de su espacio de trabajo.
- Conexiones de repositorios Git: proveedores de Git externos y sus formularios de conexión completos.