https://github.com/contrast-security-oss/agent-operator-images
Images of agents for the agent-operator.
https://github.com/contrast-security-oss/agent-operator-images
Last synced: 4 months ago
JSON representation
Images of agents for the agent-operator.
- Host: GitHub
- URL: https://github.com/contrast-security-oss/agent-operator-images
- Owner: Contrast-Security-OSS
- License: other
- Created: 2022-05-03T21:27:18.000Z (about 4 years ago)
- Default Branch: master
- Last Pushed: 2025-07-03T14:13:52.000Z (12 months ago)
- Last Synced: 2025-07-10T17:36:43.695Z (12 months ago)
- Language: Dockerfile
- Size: 1.03 MB
- Stars: 1
- Watchers: 6
- Forks: 3
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# agent-operator-images
Images for the [agent-operator](https://github.com/Contrast-Security-OSS/agent-operator) project.
Managed by the Contrast .NET agent team.
## Images
Public images are deployed to DockerHub. Currently, this repo publishes:
- [](https://hub.docker.com/r/contrast/agent-dotnet-core)
- [](https://hub.docker.com/r/contrast/agent-dotnet-framework)
- [](https://hub.docker.com/r/contrast/agent-java)
- [](https://hub.docker.com/r/contrast/agent-nodejs)
- [](https://hub.docker.com/r/contrast/agent-php)
- [](https://hub.docker.com/r/contrast/agent-python)
- [](https://hub.docker.com/r/contrast/agent-flex)
Tags are generated in the following format:
```
:2
:2.1
:2.1.10
:latest
```
## Image layout
All images contain a directory of `/contrast` containing all the agent files. This directory is stable and may be publicly documented.
Inside this directory is a json file `image-manifest.json` with the layout of:
```json
{
"version": "${VERSION}"
}
```
This file may be used by agents or for debugging containerized deployments in production. Additional information may be added in the future.
Upon starting, the default entrypoint of these images will copy all files from `/contrast` to `$CONTRAST_MOUNT_PATH` (defaults to `/contrast-init`) and exit. Some agents may require a specific `CONTRAST_MOUNT_PATH` to function correctly.
> The .NET Framework agent image does not contain an entrypoint and should only be used to aid in creating base images for Windows Containers. .NET Framework agent files are located in `C:\Contrast`.
## Updating Images
Images are updated by executing a repository dispatch with a provided PAT.
```bash
curl -H "Authorization: token ${GH_PAT}" \
-H 'Accept: application/vnd.github.everest-preview+json' \
"https://api.github.com/repos/Contrast-Security-OSS/agent-operator-images/dispatches" \
-d '{"event_type": "oob-update", "client_payload": {"type": "dotnet-core", "version": "2.1.12"}}'
```
Once the dispatch request is received, the following events execute automatically:
- A PR with the requested version is created on a new branch.
- Basic checks are executed to ensure the version can be built.
- Upon successful validation, the PR is automatically merged into trunk.
Merging into trunk starts the following events:
- Create and publish all images in this repository.
- When all images have been built successfully, start a deployment to `internal`. This copies the artifact images from the first step, with final image tags.
- When the internal environment deployment has succeeded, start a deployment to `public`.
## Creating Backports
Backports may be created by pushing a branch in the format of `backport/-v` with the version of the agent being backported. Backports will not update the `latest` tag and will not update the Major/Minor tags.