github.com/cockroachdb/cockroach@v20.2.0-alpha.1+incompatible/pkg/acceptance/testdata/README.md (about)

     1  # Acceptance Test Harnesses
     2  
     3  The Dockerfile in this directory builds an image, `cockroachdb/acceptance`, in
     4  which we run our language-specific acceptance tests. For each language we
     5  support, we install the compiler or runtime, and typically the Postgres driver,
     6  into the image. Where possible, we use packages provided by Debian; otherwise we
     7  invoke the language's package manager while building the image.
     8  
     9  In all cases, the language's package manager is removed or put into offline mode
    10  before the image is fully baked to ensure that we don't accidentally introduce a
    11  dependency on an external package repository into our CI pipeline. That means
    12  that if you update a language's dependencies (e.g., `node/package.json`), you'll
    13  need to update the image.
    14  
    15  To build a new acceptance image:
    16  
    17  ```bash
    18  $ docker build -t cockroachdb/acceptance .
    19  ```
    20  
    21  To push the just-built acceptance image to the registry:
    22  
    23  ```bash
    24  $ version=$(date +%Y%m%d-%H%M%S)
    25  $ docker tag cockroachdb/acceptance cockroachdb/acceptance:$version
    26  $ docker push cockroachdb/acceptance:$version
    27  ```
    28  
    29  No need to have your changes reviewed before you push an image, as we pin the
    30  container version to use in `../util_docker.go`. Once your changes are ready for
    31  review, update the pinned version and submit a PR.