datadog ci

CI de dados

Execute comandos de seus pipelines de integração contínua (CI) e entrega contínua (CD) para integração com produtos Datadog existentes.

Consulte a seção Uso para obter uma lista de comandos disponíveis.

Como instalar a CLI

O pacote está em @datadog/datadog-ci e pode ser instalado através do NPM ou Yarn:

 # NPMnpm install --save-dev @datadog/datadog-ci# Yarnyarn add --dev @datadog/datadog-ci

Se você precisar datadog-ci como uma ferramenta CLI em vez de um pacote, poderá executá-lo com npx ou instalá-lo globalmente:

 # npxnpx @datadog/datadog-ci [comando]# NPM install globallynpm install -g @datadog/datadog-ci# Yarn v1 add globallyyarn global add @datadog/datadog-ci

Para obter mais maneiras de instalar a CLI, consulte esta seção.

Uso

 Uso: datadog-ci <comando> [<subcomando>] [opções]

Os valores a seguir estão disponíveis para cada <command> e (opcionalmente) <subcommand> .

Consulte o README vinculado de cada comando para obter mais detalhes ou clique em? para ver a página de documentação relacionada.

cloud-run

• flare : solucione seus problemas com a configuração do serviço Cloud Run. ?

dsyms

• upload : carregue arquivos dSYM do iOS para rastreamento de erros (somente macOS). ?

flutter-symbols

• upload : carrega símbolos Flutter para rastreamento de erros. ?

unity-symbols

• upload : carrega símbolos do Unity para rastreamento de erros.

git-metadata

• upload : carregue metadados do Git para a integração do código-fonte. ?

junit

• upload : carrega relatórios de teste JUnit para visibilidade de teste. ?

lambda

• flare : solucione seus problemas com a instrumentação do Datadog em suas funções do AWS Lambda.

• instrument : aplique a instrumentação do Datadog às funções fornecidas do AWS Lambda.

• uninstrument : reverte a instrumentação do Datadog das funções fornecidas do AWS Lambda.

measure

• Adicione medidas a um rastreamento de pipeline de visibilidade de CI ou período de trabalho no Datadog. ?

react-native

• codepush : Carregue mapas de origem React Native CodePush para rastreamento de erros. ?

• upload : Carregue mapas de origem React Native para rastreamento de erros. ?

• xcode : Carregue mapas de origem React Native para rastreamento de erros da fase de construção do pacote XCode. ?

sarif

• upload : Carregue relatórios do Static Analysis Results Interchange Format (SARIF) para o Datadog. ?

sbom

• upload : carregue arquivos de lista de materiais de software (SBOM) para o Datadog. ?

sourcemaps

• upload : carregue mapas de origem JavaScript para rastreamento de erros. ?

stepfunctions

• instrument : instrumento AWS Step Function com Datadog para obter logs e rastreamentos. ?

• uninstrument : Desinstrumentar função AWS Step. ?

synthetics

• run-tests : execute testes de teste contínuo do CI. ?

• upload-application : carregue uma nova versão para um aplicativo móvel existente no Datadog. ?

tag

• Adicione tags personalizadas a um rastreamento de pipeline de visibilidade de CI ou período de trabalho no Datadog. ?

trace

• Adicione comandos personalizados a um pipeline de CI Visibility no Datadog. ?

Comandos beta

A seguir estão os comandos beta , você pode habilitá-los com DD_BETA_COMMANDS_ENABLED=1 :

deployment

• mark : marca um trabalho de CI como uma implantação. ?

• correlate : correlaciona implantações de CD do GitOps com pipelines de CI de repositórios de aplicativos. ?

dora

• deployment : envie um novo evento de implantação para DORA Metrics para Datadog. ?

elf-symbols

• upload : carrega arquivos de informações de depuração do Elf para criação de perfil (requer binutils). ?

gate

• evaluate : Avalie as regras do Quality Gates no Datadog. ?

Mais maneiras de instalar a CLI

Binário independente

Se a instalação do NodeJS no CI for um problema, os binários independentes serão fornecidos com as versões. linux-x64 , linux-arm64 , darwin-x64 , darwin-arm64 (MacOS) e win-x64 (Windows) são suportados.

Para instalar:

Linux

 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

Mac OS

 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

Windows

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

Então, você pode executar comandos datadog-ci normalmente:

 versão datadog-ci

Imagem do contêiner

Para executar datadog-ci a partir de um contêiner, você pode usar a imagem datadog/ci disponível no Docker Hub, bem como os registros públicos Amazon ECR e Google GC.

 docker pull datadog/ci

Este exemplo demonstra como executar um comando usando o contêiner e passando a API e as chaves do aplicativo:

 exportar 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 sintéticos run- testes -p público-id1

Construindo sua própria imagem de contêiner

Você pode construir uma imagem usando o Dockerfile fornecido:

 recipiente de CD
docker build --tag datadog-ci.

Opcionalmente, você pode usar o argumento de construção VERSION para construir uma imagem para uma versão específica:

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

Desenvolvimento

Antes de contribuir para este projeto de código aberto, leia nosso CONTRIBUTING.md.

Licença

Licença Apache, v2.0