GitHub Release Build Status License

Información general

Con el paso synthetics-test-automation-bitrise-step-upload-application, puedes cargar una nueva versión de tu aplicación a Datadog para ejecutar tests Sintético durante tu Bitrise CI, asegurándote de que todos tus equipos que utilizan Bitrise puedan beneficiarse con las tests Sintético en cada etapa del ciclo de vida del software. Este paso utiliza el comando Datadog CI Synthetics y requiere que tu aplicación ya exista.

Configuración

Este paso no está disponible en la página oficial Bitrise Step Library. Para empezar:

  1. Añade la siguiente URL git a tu flujo de trabajo. Consulta la documentación oficial de Bitrise sobre cómo hacerlo a través de la aplicación Bitrise. También la puedes configurar localmente haciendo referencia a la URL git en tu archivo bitrise.yml.
- git::https://github.com/DataDog/synthetics-test-automation-bitrise-step-upload-application.git@1.10.0:
  1. Añada tus claves API y de aplicación a tus secretos en Bitrise.
  2. Configurar tus entradas de pasos. También puedes configurarlas en ru archivo bitrise.yml. Las únicas entradas requeridas son los dos secretos que configuraste anteriormente. Para obtener una lista completa de entradas, consulta la sección Entradas.

Cómo utilizar este paso a nivel local

Puedes ejecutar este paso directamente utilizando la Bitrise CLI.

Para ejecutar este paso localmente:

  1. Abre tu terminal o línea de comandos.
  2. git clone el repositorio Bitrise.
  3. cd en el directorio del paso (el que acabas de git clone).
  4. Crea un archivo .bitrise.secrets.yml en el mismo directorio que bitrise.yml. El archivo .bitrise.secrets.yml es un archivo ignorado por Git, por lo que puedes almacenar tus secretos en él.
  5. Check el archivo bitrise.yml para cualquier secreto que debas configurar en .bitrise.secrets.yml.
  6. Una vez que tengas los parámetros secretos necesarios en tu archivo .bitrise.secrets.yml, ejecuta este paso con la Bitrise CLI con bitrise run test.

Un ejemplo de archivo .bitrise.secrets.yml:

envs:
- A_SECRET_PARAM_ONE: the value for secret one
- A_SECRET_PARAM_TWO: the value for secret two

Uso

Ejemplo de tarea que utiliza una anulación global de configuración con configPath

Esta tarea anula la ruta al archivo global datadog-ci.config.json.

- git::https://github.com/DataDog/synthetics-test-automation-bitrise-step-upload-application.git@1.10.0:
   inputs:
   - api_key: <DATADOG_API_KEY>
   - app_key: <DATADOG_APP_KEY>
   - config_path: './synthetics-config.json'

Para ver un ejemplo de archivo de configuración, consulta el archivoglobal.config.json .

Ejemplo con todas las configuraciones posibles

Como referencia, este es un ejemplo de una configuración completa:

- git::https://github.com/DataDog/synthetics-test-automation-bitrise-step-upload-application.git@1.10.0:
   inputs:
   - api_key: <DATADOG_API_KEY>
   - app_key: <DATADOG_APP_KEY>
   - config_path: './global.config.json'
   - latest: true
   - mobile_application_version_id: '123-123-123'
   - mobile_application_version_file_path: 'path/to/application.apk'
   - site: 'datadoghq.com'
   - version_name: 'example 1.0'

Entradas

NombreRequisitoDescripción
apiKeyrequiredSu clave de API Datadog. Esta clave es creada por tu organización Datadog y se accederá a ella como una variable de entorno.
appKeyrequiredTu clave de aplicación Datadog. Esta clave es creada por tu organización Datadog y se accederá a ella como una variable de entorno.
configPathopcionalLa configuración global de JSON se utiliza al lanzar las tests. Consulta el ejemplo de configuración para obtener más detalles.
latestopcionalMarca la aplicación como latest. Cualquier test que se ejecute en la última versión utilizará esta versión en la siguiente ejecución.
mobileApplicationVersionIdrequiredID de la aplicación a la que quieres cargar la nueva versión.
mobileApplicationVersionFilePathrequiredAnula la versión de la aplicación para tests de la aplicación móvil Sintético.
siteopcionalEl sitio Datadog al que enviar los datos. Tu sitio Datadog es . Si la variable de entornoDD_SITE está configurada, tiene prioridad.
versionNamerequiredNombre de la nueva versión. Tiene que ser único.

Salidas

NombreDescripción
DATADOG_UPLOADED_APPLICATION_VERSION_IDEl ID de la versión de la aplicación que se acaba de cargar. Pásalo al paso datadog-mobile-app-run-tests con la entrada mobile_application_version para hacer un test de esta versión de la aplicación.

Referencias adicionales

Más enlaces, artículos y documentación útiles:

PREVIEWING: aliciascott/DOCS-9725-Cloudcraft