Common utilities for Camptocamp CI
Project description
C2C CI utils
Commands:
c2cciutils: some generic tools.c2cciutils-checks: Run the checks on the code (those checks don't need any project dependencies).c2cciutils-audit: Do the audit, the main difference with checks is that it can change between runs on the same code.c2cciutils-publish: Publish the project.c2cciutils-clean: Delete Docker images on Docker Hub after corresponding branch have been deleted.c2cciutils-google-calendar: Tool to test the google credentials for calendar API and refresh them if needed. Seec2cciutils-google-calendar -hfor more information.
New project
The content of example-project can be a good base for a new project.
Use locally, in the projects that use c2cciutils
Install it: python3 -m pip install --user --requirement ci/requirements.txt
Run the checkers: c2cciutils-checks [--fix] [--stop] [--check CHECK]
Dry run publish: GITHUB_REF=... c2cciutils-publish --dry-run ...
Configuration
You can get the current configuration with c2cciutils --get-config, the default configuration depends on your project.
You can override the configuration with the file ci/config.yaml.
At the base of the configuration you have:
version: Contains some regular expressions to find the versions branches and tags, and to convert them into application versions.checks: The checkers configuration, seec2cciutils/checks.pyfor more information.audit: The audit configuration, seec2cciutils/audit.pyfor more information.publish: The publish configuration, seec2cciutils/publish.pyfor more information.
Many actions can be disabled by setting the corresponding configuration part to False.
Checks
The configuration profile consider we use a project with:
- Dependabot.
- The following workflows:
Continuous integration,Rebuildon all supported branch,Auditfor security issues on all supported branches,Backportbetween all supported branches,Clean Docker hub tags,Auto merge Dependabot updates.
- A
SECURITY.mdfile.
It will check that:
- All the workflows are conform on what we expect,
- All the workflows are completely configured for all the versions present in
SECURITY.mdfile. - The code is conform with the
blackandisortrules. - The
gitattributesare valid. - All text files end with an empty line.
IDE
The IDE should be configured as:
- using
blackandisortwithout any arguments, - using the
editorconfigconfiguration.
Publishing
To pypi
When publishing, the version computed from arguments or GITHUB_REF is put in environment variable VERSION, thus you should use it in setup.py, example:
VERSION = os.environ.get("VERSION", "1.0.0")
The config is like this:
versions: # List of kinds of versions you want to publish, that can be: rebuild (specified with --type),
# version_tag, version_branch, feature_branch, feature_tag (for pull request)
To Docker registry
The config is like this:
images:
- name: # The base name of the image we want to publish
repository:
<internal_name>:
"server": # The fqdn name of the server if not Docker hub
"version": # List of kinds of versions you want to publish, that can be: rebuild (specified using --type),
# version_tag, version_branch, feature_branch, feature_tag (for pull request)
"tags": # List of tags we want to publish interpreted with `template(version=version)`
# e.-g. if you use `{version}-lite` when you publish the version `1.2.3` the source tag
# (that should be built by the application build) is `latest-lite`, and it will be published
# with the tag `1.2.3-lite`.
"group": # If your images are published by different jobs you can separate them in different groups
# and publish them with `c2cciutils-publish --group=<group>`
With the c2cciutils-clean the images on Docker hub for feature_branch will be removed on branch removing.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Hashes for c2cciutils-1.0.dev20210108163130-py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e354d047357771d10d6977b9fe91ba7778b11d9886765dddf329a6d91fc73736 |
|
| MD5 | 8e9812a015fc30808337e619cc990a15 |
|
| BLAKE2b-256 | f7ea68502a3ca879b00fc413d3b9f6d878706cb359f727f4e5f1ffcfa26fbec3 |
