annotations
Annotations for the manifest.
Most org.opencontainers.image
annotations are set automatically if the GitHub option is enabled.
Type: attribute set of anything
Default:
{ }
autoTags
Configuration for tags that are generated automatically.
Type: submodule
Default:
{ }
autoTags.branch
Whether to enable add a tag based on the branch name.
Type: boolean
Default:
true
Example:
false
autoTags.latest
Whether to enable add a ‘latest’ tag if branch == defaultBranch
.
Type: boolean
Default:
true
Example:
false
autoTags.major
Whether to enable add a tag based on the major version (e.g., 1
).
Type: boolean
Default:
true
Example:
false
autoTags.majorMinor
Whether to enable add a tag based on the major and minor version (e.g., 1.2
).
Type: boolean
Default:
true
Example:
false
autoTags.version
Whether to enable add a tag based on the version (e.g., 1.2.3
).
Type: boolean
Default:
true
Example:
false
branch
Name of the git branch (e.g., main
).
Type: null or string
Default:
"github.branch || null"
defaultBranch
Name of the git branch that is used as default for the latest
tag.
Type: string
Default:
"if `github.enable` then `$GITHUB_DEFAULT_BRANCH` else `main`"
format
The format of the manifest
Type: one of “oci”, “v2s2”
Default:
"oci"
github
GitHub integration configuration
Type: submodule
Default:
{ }
github.enable
Whether the GitHub integration is enabled.
If set to true
, you need to run nix with the --impure
flag in order to access the GitHub API.
Type: boolean
Default:
false
Example:
true
github.enableRegistry
Whether to enable the GitHub container registry.
Type: boolean
Default:
true
Example:
false
github.actor
GitHub actor.
Used as default value for registries."ghcr.io".username
.
Type: null or string
Default:
"$GITHUB_ACTOR || null"
github.apiEndpoint
GitHub API endpoint. Can be used for custom GitHub installations.
Type: string
Default:
"https://api.github.com"
github.branch
Name of the git branch.
Type: null or string
Default:
"$GITHUB_REF_NAME || null"
github.registry
Name of the GitHub registry
Type: string
Default:
"ghcr.io"
github.repo
Full name of the GitHub repository (e.g., mirkolenz/flocken
).
Used as default value for registries."ghcr.io".repo
.
Type: null or string
Default:
"$GITHUB_REPOSITORY || null"
github.token
GitHub access token.
Used as default value for registries."ghcr.io".password
.
Type: string
Default:
"$GITHUB_TOKEN"
imageFiles
List of Docker images to be added to the manifest.
Can for instance be produced using dockerTools.buildLayeredImage
.
Note: This should be a list of identical images for different architectures.
Type: list of package
Default:
[ ]
imageStreams
List of Docker image streams to be added to the manifest.
Can for instance be produced using dockerTools.streamLayeredImage
.
Note: This should be a list of identical images for different architectures.
Type: list of package
Default:
[ ]
images
Alias of imageFiles
.
Type: list of package
manifestName
The name of the manifest
Type: string
Default:
"flocken"
registries
Configuration for the Docker registries to be used.
The key is the name of the registry (e.g., ghcr.io
).
Type: attribute set of (submodule)
Default:
{ }
registries.<name>.enable
Whether to enable pushing to the registry.
Type: boolean
Default:
true
Example:
false
registries.<name>.name
The name/domain of the registry
Type: string
Default:
"‹name›"
registries.<name>.password
Password for pushing to the registry.
Type: string
registries.<name>.repo
Fully qualified name of the Docker image in the registry (e.g., mirkolenz/flocken
).
Type: string
registries.<name>.username
Username for pushing to the registry.
Type: string
tags
List of custom/additional tags to be added to the manifest.
Type: list of string
Default:
[ ]
version
Semantic version of the image (e.g., v1.0.0
or 1.0.0
).
Type: null or string
Default:
"$VERSION || null"