This directory contains tools and scripts used to create development and testing environments for cert-manager.
The scripts in this directory commonly require additional tooling, such as
access to kubectl
, helm
, kind
and a bunch of other things.
If you already have these tools available on your host system, the scripts should just work, so long as the versions you have installed are roughly compatible.
If you are running into issues with your host-installed tools, you can
have them downloaded in bin/tools
with the command:
# With "-j8", the tools are downloaded in parallel.
make -j8 tools
To setup your shell to use the tools, run the following from the root of the repository:
export PATH="$PWD/bin/tools:$PATH"
Tip: this change of PATH won't persist between shell sessions. To get this command executed automatically when you enter the cert-manager folder, put this command in an
.envrc
file in the cert-manager folder and installdirenv
.
This section describes common usage patterns for development and testing.
Once you have a kind cluster running, you can install a development version of cert-manager by running:
make -j8 e2e-setup-certmanager
This will create a kind cluster, build, load and install cert-manager from source into your kind development cluster.
Further invocations of this command will rebuild and upgrade the installed version of cert-manager, making it possible to iteratively work on the codebase and test changes.
Before running the end-to-end tests, you must install some additional components used during the tests into your kind cluster.
Run the following to setup cert-manager, Pebble, ingress-nginx, the sample DNS01 webhook and all the other components required for the end-to-end tests:
make -j8 e2e-setup
You only need to run this command once for the lifetime of your test cluster.
Finally, run the end-to-test tests using:
make e2e
You can run this command multiple times against the same cluster without adverse effects.
A common use-case is to run a single test case from the end-to-end tests.
This is explained in the --help
:
./make/e2e.sh --help
Once you have finished with your testing environment, or if you have
encountered a strange state you cannot recover from, you can tear down the
testing environment by using kind
directly:
kind delete cluster [--name=$KIND_CLUSTER_NAME]