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 en Datadog para ejecutar tests Synthetic durante tu Bitrise CI, asegurándote de que todos tus equipos que utilizan Bitrise puedan beneficiarse de los tests Synthetic en cada etapa del ciclo de vida del software.

Este paso requiere que tu aplicación ya exista en Datadog.

Para obtener más información sobre la configuración disponible, consulta la documentación de datadog-ci upload-application.

Configuración

Este paso no está disponible en la Biblioteca de pasos oficial de Bitrise. 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@v2.7.0:
  1. Añade tus claves de API y de aplicación a tus secretos en Bitrise.
  2. Configurar tus entradas de pasos. También puedes configurarlas en tu 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 de entradas.

Cuando se ejecuta el paso localmente con la Bitrise CLI, los secretos deben almacenarse en un archivo .bitrise.secrets.yml. Consulta Gestión local de secretos.

Utilización

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

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

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

Ejemplo con todas las configuraciones posibles

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

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

Entradas

Para obtener más información sobre la configuración disponible, consulta la documentación de datadog-ci upload-application.

NombreDescripción
api_key(Obligatorio) Tu clave de API Datadog. Esta clave se crea en tu organización Datadog y debe almacenarse como secreto.
app_key(Obligatorio) Tu clave de aplicación Datadog. Esta clave se crea en tu organización Datadog y debe almacenarse como secreto.
config_pathLa ruta al archivo de configuración global que configura datadog-ci.
Por defecto: datadog-ci.json
datadog_siteTu sitio Datadog. Los valores posibles se enumeran en esta tabla.
Por defecto: datadoghq.com

Configúralo como (asegurarse de seleccionar el SITIO correcto a la derecha).
latestMarca la nueva versión como latest. Cualquier test que se ejecute en la versión más reciente utilizará esta versión en su próxima ejecución.
Por defecto: false
mobile_application_id(Obligatorio) El ID de la aplicación a la que quieres cargar la nueva versión.
mobile_application_version_file_path(Obligatorio) La ruta a la nueva versión de tu aplicación móvil (.apk o .ipa). Puedes utilizar $BITRISE_IPA_PATH o $BITRISE_APK_PATH de los pasos de compilación anteriores.
version_name(Obligatorio) El nombre 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 de Bitrise para ejecutar tests con la entrada mobile_application_version para probar esta versión de la aplicación.

Referencias adicionales

Documentación útil adicional, enlaces y artículos: