de5c0bf381
When checking how User-Agent headers would differ from v1.7.1 to
v1.8.0, The User-Agent looked off:
cert-manager-issuers/v1.8.0 (linux/amd64) cert-manager/
The ending "/" should be followed by the git commit hash. It seems like
we forgot to port what Bazel does to fill AppVersion, AppGitCommit, and
AppGitState. This commit adds this feature to the Makefile. The
User-Agent should now look like this:
cert-manager-issuers/v1.8.0 (linux/amd64) cert-manager/9dd5f6c85fde2c3ed58cd6c9e465bb5a4c1ca2b2
<----->
This part depends
on the component.
Signed-off-by: Maël Valais <mael@vls.dev>
|
||
|---|---|---|
| .. | ||
| config | ||
| base_images.mk | ||
| ci.mk | ||
| cluster.sh | ||
| cmctl.mk | ||
| containers.mk | ||
| e2e-setup.mk | ||
| e2e.sh | ||
| git.mk | ||
| help.mk | ||
| licenses.mk | ||
| manifests.mk | ||
| README.md | ||
| release.mk | ||
| server.mk | ||
| test.mk | ||
| tools.mk | ||
Development tooling
This directory contains tools and scripts used to create development and testing environments for cert-manager.
Tool dependencies
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
.envrcfile in the cert-manager folder and installdirenv.
Common usages
This section describes common usage patterns for development and testing.
Installing a development build of cert-manager
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.
Running end-to-end tests
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
Deleting the test cluster
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]