Skip to content

build.md

Latest commit

 

History

History
83 lines (57 loc) · 3.12 KB

build.md

File metadata and controls

83 lines (57 loc) · 3.12 KB

Description

Build images used for system tests.

Usage

    ./build.sh <library_name> [--images <image_names>] [--weblog-variant <variant_name>]

Options

  • <library_name>: library to test. See LIBRARIES section.
  • -i: Comma separated list of images you need to build. See Image names section for possible values. Default: all of them
  • --images: Same as -i
  • -w: Name of a weblog variation
  • --weblog-variant: same as -w

Image names

  • weblog: Web app that ships the library.
  • agent: Host for datadog agent.
  • runner: Test runner.

Libraries names

  • cpp
  • dotnet
  • golang
  • java
  • nodejs
  • php
  • python
  • ruby

Weblog variants

  • For cpp: poc (default)
  • For dotnet: poc (default), uds
  • For golang: net-http (default), gin, echo, chi
    • Specific to the GRAPHQL_APPSEC scenario: gqlgen, graph-gophers, graphql-go
  • For java: spring-boot (default),akka-http,jersey-grizzly2,play,ratpack,resteasy-netty3,spring-boot-3-native,spring-boot-jetty,spring-boot-openliberty,spring-boot-payara,spring-boot-undertow,spring-boot-wildfly,uds-spring-boot,vertx3,vertx4
  • For nodejs: express4 (default), express4-typescript, express5, nextjs, fastify
  • For php: apache-mod-8.1, apache-mod-8.0 (default), apache-mod-7.4, apache-mod-7.3, apache-mod-7.2, apache-mod-7.1, apache-mod-7.0, apache-mod-8.1-zts, apache-mod-8.0-zts, apache-mod-7.4-zts, apache-mod-7.3-zts, apache-mod-7.2-zts, apache-mod-7.1-zts, apache-mod-7.0-zts, php-fpm-8.1, php-fpm-8.0, php-fpm-7.4, php-fpm-7.3, php-fpm-7.2, php-fpm-7.1, php-fpm-7.0
  • For python: flask-poc (default), fastapi, uwsgi-poc, django-poc, python3.12
  • For ruby: rails70 (default), rack, sinatra21, and lot of other sinatra/rails versions

Real life examples

By default, all images will uses production version of components (library and agent). You can use a specific version of a component by adding it inside binaries/ (documentation). The main idea behind this behavior is to test a specific version against production version of other components.

Environement variables

You can define your setup in environment variable in a .env file. Here is the mapping:

  • <library_name> => TEST_LIBRARY
  • -i/--images => BUILD_IMAGES
  • -w/--weblog-variant => WEBLOG_VARIANT

Authentication for pulling images

Some images are hosted at Github. Those images require authentication.

If you find an error messages like:

Error response from daemon: Head "https://ghcr.io/v2/datadog/system-tests-apps-ruby/rails70/manifests/latest": unauthorized

You have to make to sure to authenticate before pulling the images.

  1. Create a Github token. The token has to have package read and write perimssions. You can create the token using this link: https://github.com/settings/tokens/new?scopes=write:packages
  2. Make sure to enable SSO for the new token.
  3. Authenticate docker: 3.1 docker login ghcr.io 3.2 paste your Github username 3.2 paste the token string from step 1.