Ejecute tuberías localmente
GitTree prepara el comando exacto act o gitlab-ci-local para un archivo de flujo de trabajo o un trabajo y lo escribe en una nueva terminal para que usted lo ejecute. Los trabajos se ejecutan en Docker contenedores en su computadora, antes de enviarlos. Las canalizaciones locales son parte del plan gratuito y no necesitan una cuenta de alojamiento.
Funciona en GitTree Gratis: todas las funciones locales de Git, sin necesidad de cuenta.
En esta página
Antes de empezar
- Docker, en ejecución: Docker Desktop, OrbStack, Colima o Docker Engine. Ambos corredores comienzan cada trabajo en un contenedor.
- El corredor de su archivo: act para GitHub Actions (
.github/workflows/*.yml), gitlab-ci-local para GitLab CI (.gitlab-ci.yml). Instálelo fuera del repositorio, en una carpeta en PATH. - Un repositorio confiable (confianza del repositorio): una ejecución local ejecuta el código del repositorio.
- Un shell de terminal compatible: bash, zsh, sh o fish en macOS; PowerShell en Windows; bash, zsh, sh o fish en Linux.
donde encontrarlo
- El botón CI/CD en la barra de herramientas: sin una cuenta conectada o Pro, la vista se abre en Local pipelines.
- La sección TOOLS del panel izquierdo: Prepare local pipeline.
- Tools en la barra de herramientas (al lado de Terminal) o en el menú de la pestaña del repositorio: Prepare local pipeline…, también en la paleta de comandos o con
Alt+Shift+L.
| acción | macOS | Windows y Linux |
|---|---|---|
| La paleta de comandos, luego Prepare local pipeline… | ⌘⇧P | Ctrl+Shift+P |
| Show CI/CD | ⌥P | Alt+P |
Pasos
Consulta lo que necesitas
Abra CI/CD. Local pipelines enumera What you need: Docker, act y gitlab-ci-local con Found o Not found y dónde se encontró cada uno, la confianza del repositorio y el shell del terminal. Un programa faltante muestra cómo instalarlo; instálelo y luego presione Check again. Ask Nour to Set Up the Local Runner es parte de Pro, que todos tienen ahora mismo sin costo alguno. La preparación y ejecución del comando localmente no.
Las tuberías locales están marcadas como Libres. Las ejecuciones alojadas por encima de ellas aún necesitan una cuenta conectada.GitTree interfaz con un repositorio de demostración. Agregue un archivo de canalización o use el suyo
Pipeline files in this repository enumera cada archivo con Ready to run o el motivo por el que no se puede ejecutar. Sin ningún archivo todavía, Add GitHub Actions sample escribe
.github/workflows/gittree-local.ymly Add GitLab CI sample escribe.gitlab-ci.yml, cada uno con dos trabajos comentados. GitTree nunca escribe sobre un archivo existente. El archivo se abre en el editor: coloque sus comandos de compilación y prueba en él.preparar el comando
Presione Run Locally…. En Prepare local pipeline, elija Pipeline config, Job o Runner default jobs, y Terminal shell, luego Prepare command. Nada funciona todavía.
Ejecútelo en la terminal.
Lea el Prepared command, luego Type in new terminal. GitTree lo escribe en una nueva terminal y nunca presiona Enter: revíselo y presione Enter usted mismo. La salida del trabajo aparece en la terminal.
Resultado esperado
El corredor extrae la imagen del trabajo la primera vez, luego ejecuta cada paso en un contenedor e imprime su resultado en la terminal. Los archivos de su repositorio se utilizan tal como están en el disco, confirmados o no.
Instale Docker y los corredores
| Programa | macOS | Windows | Linux |
|---|---|---|---|
| Docker | Docker Desktop, OrbStack o Colima | Docker Desktop | Docker Engine o Docker Desktop |
| actuar (GitHub Actions) | brew install act | winget install nektos.act | El script de instalación en nektosact.com |
| gitlab-ci-local (GitLab CI) | npm install -g gitlab-ci-local | El .exe de sus versiones GitHub, en una carpeta en PATH | npm install -g gitlab-ci-local |
gitlab-ci-local necesita Node.js 18 o posterior cuando se instala con npm. GitTree solo busca los programas en PATH; nunca los ejecuta para verificar, por lo que no puede saber si el motor Docker está iniciado.
Los archivos de muestra
El ejemplo GitHub Actions ejecuta un trabajo build y luego un trabajo test en ubuntu-latest. En su primera ejecución, el acto pregunta qué imagen de corredor usar; Medium se adapta a la mayoría de los proyectos. El ejemplo GitLab CI ejecuta los mismos dos trabajos en contenedores alpine. Reemplace las líneas echo con sus propios comandos, luego confirme el archivo cuando esté listo. Si el repositorio está en GitHub o GitLab, ese host también ejecuta el archivo.
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Build
run: npm ci && npm run build
test:
runs-on: ubuntu-latest
needs: build
steps:
- uses: actions/checkout@v4
- name: Test
run: npm testBitbucket Pipelines y Azure Pipelines
No hay ningún corredor local compatible para bitbucket-pipelines.yml o azure-pipelines.yml, por lo que esos archivos muestran No local runner. Para ejecutar los mismos pasos en su computadora, agregue el ejemplo GitHub Actions o GitLab CI y copie sus comandos en él. La canalización alojada sigue ejecutándose desde su propio archivo.
En qué se diferencia una carrera local de tu anfitrión
- Los secretos y variables establecidos en el host no están disponibles; pase usted mismo los que necesita un trabajo al corredor.
- act ejecuta trabajos activados por inserción de forma predeterminada. Elija un Job para ejecutar uno independientemente de su desencadenante.
- Las inclusiones, plantillas y flujos de trabajo reutilizables no se resuelven cuando GitTree enumera trabajos; el corredor los resuelve cuando corre.
- Los contenedores pueden llegar a su red y utilizar las credenciales que usted les proporcione.
Si algo sale mal
"No se encontró ningún corredor nativo seguro en PATH. Instálelo fuera del repositorio y luego actualice".
Instale act o gitlab-ci-local en una carpeta en PATH que no esté dentro del repositorio, luego presione Check again o Refresh. El macOS, cierre y vuelva a abrir GitTree si cambió la RUTA en su perfil de shell.
"La configuración de este proveedor no tiene un corredor local compatible".
El archivo es una canalización de Bitbucket o Azure. Agregue una muestra GitHub Actions o GitLab CI y copie los pasos en ella.
"Confíe en este repositorio antes de preparar un comando de canalización local".
Primero confíe en el repositorio (confianza del repositorio), luego prepare el comando nuevamente.
El terminal dice que no puede conectarse al demonio Docker.
Inicie Docker Desktop, OrbStack, Colima o el servicio Docker, espere hasta que se esté ejecutando y luego presione Enter en el comando nuevamente.
Preguntas
¿Las canalizaciones locales necesitan GitTree Pro o una cuenta de hosting?
No. Las canalizaciones locales son parte del plan gratuito y solo leen los archivos de su repositorio. Las ejecuciones, reejecuciones y aprobaciones de CI/CD alojados son parte de Pro.
¿GitTree ejecuta el proceso por mí?
No. GitTree prepara el comando y lo escribe en una terminal; presionas Enter. Nada se ejecuta antes que tú.