Ajustes y argumentos suplementarios

GitHub Actions Importer tiene varios argumentos y configuraciones complementarios para adaptar el proceso de migración a sus necesidades.

En este artículo

En este artículo se proporciona información general sobre cómo configurar los argumentos y opciones complementarios de GitHub Actions Importer, como parámetros opcionales, argumentos de ruta y configuración de red.

Parámetros opcionales

GitHub Actions Importer tiene varios parámetros opcionales que puede usar para personalizar el proceso de migración.

Limitación de las acciones permitidas

Las opciones siguientes se pueden usar para limitar qué acciones se permiten en los flujos de trabajo convertidos. Cuando se usa de forma combinada, estas opciones expanden la lista de acciones permitidas. Si no se proporciona ninguna de estas opciones, se permiten todas las acciones.

  • --allowed-actions especifica una lista de acciones que se van a permitir en los flujos de trabajo convertidos. Se admite caracteres comodín. No se permitirá ninguna otra acción que no sea la proporcionada.

    Por ejemplo:

    --allowed-actions actions/checkout@v6 actions/upload-artifact@* my-org/*

    Puedes proporcionar una lista vacía para no permitir todas las acciones. Por ejemplo: --allowed-actions=.

  • --allow-verified-actions especifica que se permiten todas las acciones de creadores comprobados.

  • --allow-github-created-actions especifica que se permiten acciones publicadas desde las organizaciones github o actions.

    Por ejemplo, estas acciones incluyen github/super-linter y actions/checkout.

    Esta opción es equivalente a --allowed-actions actions/* github/*.

Uso de un archivo de credenciales para la autenticación

El --credentials-file parámetro especifica la ruta de acceso a un archivo que contiene credenciales para distintos servidores a los que GitHub Actions Importer se puede autenticar. Esto resulta útil cuando los scripts de compilación (como .travis.yml o jenkinsfile) se almacenan en varias GitHub Enterprise Server instancias.

Un archivo de credenciales debe ser un archivo YAML que contenga una lista de combinaciones de servidor y token de acceso. GitHub Actions Importer usa las credenciales de la dirección URL que coincide más estrechamente con la solicitud de red que se está realizando.

Por ejemplo:

- url: https://github.com
  access_token: ghp_mygeneraltoken
- url: https://github.com/specific_org/
  access_token: ghp_myorgspecifictoken
- url: https://jenkins.org
  access_token: abc123
  username: marty_mcfly

Para el archivo de credenciales anterior, GitHub Actions Importer usa el token ghp_mygeneraltoken de acceso para autenticar todas las solicitudes de red en https://github.com, a menos que la solicitud de red sea para un repositorio de la specific_org organización. En ese caso, en su lugar se usa el token ghp_myorgspecifictoken para autenticarse.

Proveedores de código fuente alternativos

GitHub Actions Importer puede obtener automáticamente el código fuente de repositorios que no sean GitHub. Un archivo de credenciales puede especificar provider, la dirección URL del proveedor y las credenciales necesarias para recuperar el código fuente.

Por ejemplo:

- url: https://gitlab.com
  access_token: super_secret_token
  provider: gitlab

En el ejemplo anterior, GitHub Actions Importer usa el token super_secret_token para recuperar cualquier código fuente hospedado en https://gitlab.com.

Los valores admitidos para provider son:

  • github (valor predeterminado)
  • gitlab
  • bitbucket_server
  • azure_devops

Control de características opcionales

Puede usar la --features opción para limitar las características usadas en los flujos de trabajo que GitHub Actions Importer crea. Esto resulta útil para excluir la sintaxis más reciente GitHub Actions de los flujos de trabajo al migrar a una instancia anterior GitHub Enterprise Server . Al usar la --features opción , debe especificar la versión de GitHub Enterprise Server a la que va a migrar.

Por ejemplo:

gh actions-importer dry-run ... --features ghes-3.3

Los valores admitidos para --features son los siguientes:

  • all (valor predeterminado)
  • ghes-latest
  • ghes-<number>, donde <number> es la versión de GitHub Enterprise Server, 3.0 o posterior. Por ejemplo: ghes-3.3.

Puede ver la lista de indicadores de características disponibles GitHub Actions Importer ejecutando el comando list-features. Por ejemplo:

Shell
gh actions-importer list-features

Debería ver una salida similar a la siguiente.

Available feature flags:

actions/cache (disabled):
        Control usage of actions/cache inside of workflows. Outputs a comment if not enabled.
        GitHub Enterprise Server >= ghes-3.5 required.

composite-actions (enabled):
        Minimizes resulting workflow complexity through the use of composite actions. See https://docs.github.com/en/actions/creating-actions/creating-a-composite-action for more information.
        GitHub Enterprise Server >= ghes-3.4 required.

reusable-workflows (disabled):
        Avoid duplication by re-using existing workflows. See https://docs.github.com/en/actions/using-workflows/reusing-workflows for more information.
        GitHub Enterprise Server >= ghes-3.4 required.

workflow-concurrency-option-allowed (enabled):
        Allows the use of the `concurrency` option in workflows. See https://docs.github.com/en/actions/reference/workflow-syntax-for-github-actions#concurrency for more information.
        GitHub Enterprise Server >= ghes-3.2 required.

Enable features by passing --enable-features feature-1 feature-2
Disable features by passing --disable-features feature-1 feature-2

Para alternar las banderas de funciones, puedes utilizar cualquiera de los siguientes métodos:

  • Usa las opciones --enable-features y --disable-features al ejecutar un comando gh actions-importer.
  • Usa una variable de entorno para cada marca de característica.

Puedes usar las opciones --enable-features y --disable-features para seleccionar características específicas para habilitar o deshabilitar durante el comando. Por ejemplo, el siguiente comando deshabilita el uso de actions/cache y composite-actions:

gh actions-importer dry-run ... --disable-features=composite-actions actions/cache

Puedes usar el comando configure --features para configurar interactivamente las marcas de características y escribirlas automáticamente en tu entorno:

$ gh actions-importer configure --features

✔ Which features would you like to configure?: actions/cache, reusable-workflows
✔ actions/cache (disabled): Enable
? reusable-workflows (disabled):
› Enable
  Disable

Deshabilitación del almacenamiento en caché de respuestas de red

De forma predeterminada, GitHub Actions Importer almacena en caché las respuestas de las solicitudes de red para reducir la carga de red y reducir el tiempo de ejecución. Puede usar la opción --no-http-cache para deshabilitar la caché de red. Por ejemplo:

gh actions-importer forecast ... --no-http-cache

Argumentos de ruta

Al ejecutar GitHub Actions Importer, los argumentos de ruta de acceso son relativos al disco del contenedor, por lo que no se admiten rutas de acceso absolutas relativas a la máquina host del contenedor. Cuando GitHub Actions Importer se ejecuta, el directorio del /data contenedor se monta en el directorio donde GitHub Actions Importer se ejecuta.

Por ejemplo, el comando siguiente, cuando se usa en el /Users/mona directorio , genera el GitHub Actions Importer resumen de auditoría en el /Users/mona/out directorio:

gh actions-importer audit --output-dir /data/out

Uso de un proxy

Para acceder a los servidores configurados con un proxy HTTP, debe establecer las siguientes variables de entorno con la dirección URL del proxy:

  • OCTOKIT_PROXY: para cualquier GitHub servidor.
  • HTTP_PROXY (o HTTPS_PROXY): para cualquier otro servidor.

Por ejemplo:

export OCTOKIT_PROXY=https://proxy.example.com:8443
export HTTPS_PROXY=$OCTOKIT_PROXY

Si el proxy necesita autenticación, se debe incluir un nombre de usuario y una contraseña en la dirección URL del proxy. Por ejemplo: https://username:password@proxy.url:port.

Deshabilitación de la comprobación del certificado SSL

De forma predeterminada, GitHub Actions Importer comprueba los certificados SSL al realizar solicitudes de red. Puedes deshabilitar la comprobación del certificado SSL con la opción --no-ssl-verify. Por ejemplo:

gh actions-importer audit --output-dir ./output --no-ssl-verify

Algunas partes se han adaptado a partir de https://github.com/github/gh-actions-importer/ con licencia MIT:

MIT License

Copyright (c) 2022 GitHub

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.