датадог ци

Датадог CI

Выполняйте команды из конвейеров непрерывной интеграции (CI) и непрерывной доставки (CD) для интеграции с существующими продуктами Datadog.

См. раздел «Использование» для получения списка доступных команд.

Как установить интерфейс командной строки

Пакет находится под @datadog/datadog-ci и может быть установлен через NPM или Yarn:

 # Установка NPMnpm --save-dev @datadog/datadog-ci# Yarnyarn add --dev @datadog/datadog-ci

Если вам нужен datadog-ci как инструмент CLI, а не пакет, вы можете запустить его с помощью npx или установить глобально:

 # npxnpx @datadog/datadog-ci [команда]# NPM install globallynpm install -g @datadog/datadog-ci# Yarn v1 add globallyyarn global add @datadog/datadog-ci

Дополнительные способы установки CLI см. в этом разделе.

Использование

 Использование: datadog-ci <команда> [<подкоманда>] [опции]

Следующие значения доступны для каждой и (необязательно) .

Для получения более подробной информации ознакомьтесь с файлами README, связанными с каждой командой, или нажмите ? чтобы просмотреть соответствующую страницу документации.

cloud-run

• flare : Устраните проблемы с настройкой службы Cloud Run. ?

dsyms

• upload : загрузить файлы iOS dSYM для отслеживания ошибок (только для macOS). ?

flutter-symbols

• upload : загрузить символы Flutter для отслеживания ошибок. ?

unity-symbols

• upload : загрузить символы Unity для отслеживания ошибок.

git-metadata

• upload : загрузить метаданные Git для интеграции исходного кода. ?

junit

• upload : загрузить отчеты о тестировании JUnit для обеспечения видимости тестов. ?

lambda

• flare : Устраните проблемы с инструментами Datadog в функциях AWS Lambda.

• instrument : применить инструментарий Datadog к заданным функциям AWS Lambda.

• uninstrument : отменить инструментирование Datadog из заданных функций AWS Lambda.

measure

• Добавьте меры в трассировку конвейера видимости CI или диапазон заданий в Datadog. ?

react-native

• codepush : загрузите исходные карты React Native CodePush для отслеживания ошибок. ?

• upload : загрузите исходные карты React Native для отслеживания ошибок. ?

• xcode : загрузите исходные карты React Native для отслеживания ошибок на этапе сборки пакета XCode. ?

sarif

• upload : загрузить отчеты в формате обмена результатами статического анализа (SARIF) в Datadog. ?

sbom

• upload : загрузить файлы спецификации программного обеспечения (SBOM) в Datadog. ?

sourcemaps

• upload : загрузите исходные карты JavaScript для отслеживания ошибок. ?

stepfunctions

• instrument : инструмент AWS Step Function с Datadog для получения журналов и трассировок. ?

• uninstrument : Шаговая функция Uninstrument AWS. ?

synthetics

• run-tests : запуск тестов непрерывного тестирования из CI. ?

• upload-application : загрузите новую версию в существующее мобильное приложение в Datadog. ?

tag

• Добавьте пользовательские теги в трассировку конвейера видимости CI или диапазон заданий в Datadog. ?

trace

• Добавьте пользовательские команды в конвейер видимости CI в Datadog. ?

Бета-команды

Ниже приведены бета- команды, их можно включить с помощью DD_BETA_COMMANDS_ENABLED=1 :

deployment

• mark : пометить задание CI как развертывание. ?

• correlate : соотносит развертывания компакт-диска GitOps с конвейерами CI репозиториев приложений. ?

dora

• deployment : отправьте в Datadog новое событие развертывания для DORA Metrics. ?

elf-symbols

• upload : загрузить файлы отладочной информации Elf ​​для профилирования (требуется binutils). ?

gate

• evaluate : оценить правила Quality Gates в Datadog. ?

Дополнительные способы установки CLI

Автономный двоичный файл

Если установка NodeJS в CI является проблемой, вместе с выпусками предоставляются автономные двоичные файлы. Поддерживаются linux-x64 , linux-arm64 , darwin-x64 , darwin-arm64 (MacOS) и win-x64 (Windows).

Чтобы установить:

Линукс

 Curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_linux-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ci

MacOS

 Curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_darwin-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ci

Окна

 Invoke-WebRequest -Uri "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_win-x64" -OutFile "datadog-ci.exe"

Затем вы можете запускать команды datadog-ci в обычном режиме:

 версия datadog-ci

Изображение контейнера

Чтобы запустить datadog-ci из контейнера, вы можете использовать образ datadog/ci доступный в Docker Hub, а также общедоступные реестры Amazon ECR и Google GC.

 докер вытащить datadog/ci

В этом примере показано, как запустить команду с использованием контейнера и передать ключи API и приложения:

 экспорт DD_API_KEY=$(cat /secret/dd_api_key)export DD_APP_KEY=$(cat /secret/dd_app_key)docker run --rm -it -v $(pwd):/w -e DD_API_KEY -e DD_APP_KEY datadog/ci синтетический запуск- тесты -p pub-lic-id1

Создание собственного образа контейнера

Вы можете создать образ, используя предоставленный Dockerfile:

 компакт-диск контейнер
docker build --tag datadog-ci.

При желании вы можете использовать аргумент сборки VERSION для создания образа для конкретной версии:

 docker build --build-arg "VERSION=v1.14" --t datadog-ci .

Разработка

Прежде чем внести свой вклад в этот проект с открытым исходным кодом, прочтите наш CONTRIBUTING.md.

Лицензия

Лицензия Apache, версия 2.0