2020-07-10 07:06:39 +02:00
|
|
|
# Configuration
|
|
|
|
|
2020-07-10 07:16:16 +02:00
|
|
|
## Reference
|
|
|
|
|
2020-07-10 07:06:39 +02:00
|
|
|
A commented out `nfpm.yaml` config file example:
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
# Name. (required)
|
|
|
|
name: foo
|
|
|
|
|
|
|
|
# Architecture. (required)
|
|
|
|
arch: amd64
|
|
|
|
|
|
|
|
# Platform.
|
|
|
|
# Defaults to `linux`.
|
|
|
|
platform: linux
|
|
|
|
|
|
|
|
# Version. (required)
|
2021-01-14 19:32:10 +01:00
|
|
|
# This will expand any env var you set in the field, eg version: v${SEMVER}
|
2020-07-10 07:06:39 +02:00
|
|
|
version: v1.2.3
|
|
|
|
|
|
|
|
# Version Epoch.
|
|
|
|
# Default is extracted from `version` if it is semver compatible.
|
|
|
|
epoch: 2
|
|
|
|
|
|
|
|
# Version Prerelease.
|
|
|
|
# Default is extracted from `version` if it is semver compatible.
|
|
|
|
prerelease: beta1
|
|
|
|
|
2020-08-20 06:00:17 +02:00
|
|
|
# Version Metadata (previously deb.metadata).
|
|
|
|
# Default is extracted from `version` if it is semver compatible.
|
|
|
|
# Setting metadata might interfere with version comparisons depending on the packager.
|
|
|
|
version_metadata: git
|
|
|
|
|
|
|
|
# Version Release.
|
2021-01-14 19:32:10 +01:00
|
|
|
# This will expand any env var you set in the field, eg release: ${VERSION_RELEASE}
|
2020-08-20 06:00:17 +02:00
|
|
|
release: 1
|
|
|
|
|
2020-07-10 07:06:39 +02:00
|
|
|
# Section.
|
|
|
|
section: default
|
|
|
|
|
|
|
|
# Priority.
|
|
|
|
priority: extra
|
|
|
|
|
|
|
|
# Maintaner.
|
|
|
|
maintainer: Carlos Alexandro Becker <root@carlosbecker.com>
|
|
|
|
|
|
|
|
# Description.
|
|
|
|
# Defaults to `no description given`.
|
|
|
|
description: Sample package
|
|
|
|
|
|
|
|
# Vendor.
|
|
|
|
vendor: GoReleaser
|
|
|
|
|
|
|
|
# Package's homepage.
|
|
|
|
homepage: https://nfpm.goreleaser.com
|
|
|
|
|
|
|
|
# License.
|
|
|
|
license: MIT
|
|
|
|
|
2020-07-13 17:10:03 +02:00
|
|
|
# Changelog YAML file, see: https://github.com/goreleaser/chglog
|
|
|
|
changelog: "changelog.yaml"
|
|
|
|
|
2020-11-10 13:37:29 +01:00
|
|
|
# Disables globbing for files, config_files, etc.
|
|
|
|
disable_globbing: false
|
|
|
|
|
2020-07-10 07:06:39 +02:00
|
|
|
# Packages it replaces. (overridable)
|
|
|
|
replaces:
|
2020-09-01 21:27:29 +02:00
|
|
|
- foobar
|
2020-07-10 07:06:39 +02:00
|
|
|
|
|
|
|
# Packages it provides. (overridable)
|
|
|
|
provides:
|
2020-09-01 21:27:29 +02:00
|
|
|
- bar
|
2020-07-10 07:06:39 +02:00
|
|
|
|
|
|
|
# Dependencies. (overridable)
|
|
|
|
depends:
|
2020-09-01 21:27:29 +02:00
|
|
|
- git
|
2020-07-10 07:06:39 +02:00
|
|
|
|
|
|
|
# Recommended packages. (overridable)
|
|
|
|
recommends:
|
2020-09-01 21:27:29 +02:00
|
|
|
- golang
|
2020-07-10 07:06:39 +02:00
|
|
|
|
|
|
|
# Suggested packages. (overridable)
|
|
|
|
suggests:
|
2020-09-01 21:27:29 +02:00
|
|
|
- bzr
|
2020-07-10 07:06:39 +02:00
|
|
|
|
|
|
|
# Packages it conflicts with. (overridable)
|
|
|
|
conflicts:
|
2020-09-01 21:27:29 +02:00
|
|
|
- mercurial
|
2020-12-30 20:15:16 +01:00
|
|
|
|
2020-12-15 17:47:00 +01:00
|
|
|
# Contents to add to the package
|
2020-07-10 07:06:39 +02:00
|
|
|
# This can be binaries or any other files.
|
2020-12-15 17:47:00 +01:00
|
|
|
contents:
|
2020-12-30 20:15:16 +01:00
|
|
|
# Basic file that applies to all packagers
|
2020-12-15 17:47:00 +01:00
|
|
|
- src: path/to/local/foo
|
|
|
|
dst: /usr/local/bin/foo
|
2020-12-30 20:15:16 +01:00
|
|
|
|
|
|
|
# Simple config file
|
2020-12-15 17:47:00 +01:00
|
|
|
- src: path/to/local/foo.conf
|
|
|
|
dst: /etc/foo.conf
|
|
|
|
type: config
|
2020-12-30 20:15:16 +01:00
|
|
|
|
2021-01-30 16:47:01 +01:00
|
|
|
# Simple symlink at /usr/local/bin/foo which points to /sbin/foo, which is
|
|
|
|
# the same behaviour as `ln -s /sbin/foo /usr/local/bin/foo`.
|
|
|
|
#
|
|
|
|
# This also means that both "src" and "dst" are paths inside the package (or
|
|
|
|
# rather paths in the file system where the package will be installed) and
|
|
|
|
# not in the build environment. This is different from regular files where
|
|
|
|
# "src" is a path in the build environment. However, this convention results
|
|
|
|
# in "dst" always being the file that is created when installing the
|
|
|
|
# package.
|
|
|
|
- src: /actual/path/to/foo
|
|
|
|
dst: /usr/bin/foo
|
2020-12-30 20:15:16 +01:00
|
|
|
type: symlink
|
|
|
|
|
|
|
|
# Corresponds to `%config(noreplace)` if the packager is rpm, otherwise it is just a config file
|
2020-12-15 17:47:00 +01:00
|
|
|
- src: path/to/local/bar.conf
|
|
|
|
dst: /etc/bar.conf
|
2020-12-30 20:15:16 +01:00
|
|
|
type: config|noreplace
|
|
|
|
|
|
|
|
# These files are not actually present in the package, but the file names
|
|
|
|
# are added to the package header. From the RPM directives documentation:
|
|
|
|
#
|
|
|
|
# "There are times when a file should be owned by the package but not
|
|
|
|
# installed - log files and state files are good examples of cases you might
|
|
|
|
# desire this to happen."
|
|
|
|
#
|
|
|
|
# "The way to achieve this, is to use the %ghost directive. By adding this
|
|
|
|
# directive to the line containing a file, RPM will know about the ghosted
|
|
|
|
# file, but will not add it to the package."
|
|
|
|
#
|
|
|
|
# For non rpm packages ghost files are ignored at this time.
|
2020-12-15 17:47:00 +01:00
|
|
|
- dst: /etc/casper.conf
|
|
|
|
type: ghost
|
|
|
|
- dst: /var/log/boo.log
|
|
|
|
type: ghost
|
2020-12-30 20:15:16 +01:00
|
|
|
|
|
|
|
# You can user the packager field to add files that are unique to a specific packager
|
2020-12-15 17:47:00 +01:00
|
|
|
- src: path/to/rpm/file.conf
|
|
|
|
dst: /etc/file.conf
|
2020-12-30 20:15:16 +01:00
|
|
|
type: config|noreplace
|
2020-12-15 17:47:00 +01:00
|
|
|
packager: rpm
|
|
|
|
- src: path/to/deb/file.conf
|
|
|
|
dst: /etc/file.conf
|
2020-12-30 20:15:16 +01:00
|
|
|
type: config|noreplace
|
2020-12-15 17:47:00 +01:00
|
|
|
packager: deb
|
|
|
|
- src: path/to/apk/file.conf
|
|
|
|
dst: /etc/file.conf
|
2020-12-30 20:15:16 +01:00
|
|
|
type: config|noreplace
|
2020-12-15 17:47:00 +01:00
|
|
|
packager: apk
|
2020-12-30 20:15:16 +01:00
|
|
|
|
|
|
|
# Sometimes it is important to be able to set the mtime, mode, owner, or group for a file
|
|
|
|
# that differs from what is on the local build system at build time.
|
2020-12-15 17:47:00 +01:00
|
|
|
- src: path/to/foo
|
|
|
|
dst: /usr/local/foo
|
|
|
|
file_info:
|
|
|
|
mode: 0644
|
|
|
|
mtime: 2008-01-02T15:04:05Z
|
|
|
|
owner: notRoot
|
|
|
|
group: notRoot
|
|
|
|
|
2020-07-10 07:06:39 +02:00
|
|
|
|
|
|
|
# Empty folders your package may need created. (overridable)
|
|
|
|
empty_folders:
|
2020-09-01 21:27:29 +02:00
|
|
|
- /var/log/foo
|
2020-07-10 07:06:39 +02:00
|
|
|
|
|
|
|
# Scripts to run at specific stages. (overridable)
|
|
|
|
scripts:
|
|
|
|
preinstall: ./scripts/preinstall.sh
|
|
|
|
postinstall: ./scripts/postinstall.sh
|
|
|
|
preremove: ./scripts/preremove.sh
|
|
|
|
postremove: ./scripts/postremove.sh
|
|
|
|
|
2020-08-17 22:53:49 +02:00
|
|
|
# All fields above marked as `overridable` can be overriden for a given package format in this section.
|
|
|
|
overrides:
|
2020-08-18 21:14:13 +02:00
|
|
|
# The depends override can for example be used to provide version constraints for dependencies where
|
|
|
|
# different package formats use different versions or for dependencies that are named differently.
|
2020-08-17 22:53:49 +02:00
|
|
|
deb:
|
2020-08-18 21:14:13 +02:00
|
|
|
depends:
|
|
|
|
- baz (>= 1.2.3-0)
|
|
|
|
- some-lib-dev
|
2020-08-17 22:53:49 +02:00
|
|
|
# ...
|
|
|
|
rpm:
|
2020-08-18 21:14:13 +02:00
|
|
|
depends:
|
|
|
|
- baz >= 1.2.3-0
|
|
|
|
- some-lib-devel
|
2020-08-17 22:53:49 +02:00
|
|
|
# ...
|
|
|
|
apk:
|
|
|
|
# ...
|
|
|
|
|
2020-11-08 21:10:27 +01:00
|
|
|
# Custom configuration applied only to the RPM packager.
|
2020-07-10 07:06:39 +02:00
|
|
|
rpm:
|
2021-04-22 20:48:06 +02:00
|
|
|
# RPM specific scripts.
|
|
|
|
scripts:
|
|
|
|
# The pretrans script runs before all RPM package transactions / stages.
|
|
|
|
pretrans: ./scripts/pretrans.sh
|
|
|
|
# The posttrans script runs after all RPM package transactions / stages.
|
|
|
|
posttrans: ./scripts/posttrans.sh
|
|
|
|
|
2020-08-04 20:41:54 +02:00
|
|
|
# The package group. This option is deprecated by most distros
|
|
|
|
# but required by old distros like CentOS 5 / EL 5 and earlier.
|
|
|
|
group: Unspecified
|
2020-07-10 07:06:39 +02:00
|
|
|
|
2020-11-08 18:49:40 +01:00
|
|
|
# The package summary. This is, by default, the first line of the
|
|
|
|
# description, but can be explicitly provided here.
|
|
|
|
summary: Explicit Summary for Sample Package
|
|
|
|
|
2020-07-10 07:06:39 +02:00
|
|
|
# Compression algorithm.
|
|
|
|
compression: lzma
|
|
|
|
|
2020-09-17 14:18:44 +02:00
|
|
|
# The package is signed if a key_file is set
|
|
|
|
signature:
|
|
|
|
# PGP secret key (can also be ASCII-armored), the passphrase is taken
|
|
|
|
# from the environment variable $NFPM_RPM_PASSPHRASE with a fallback
|
2021-04-08 20:15:11 +02:00
|
|
|
# to $NFPM_PASSPHRASE.
|
2021-01-14 19:32:10 +01:00
|
|
|
# This will expand any env var you set in the field, eg key_file: ${SIGNING_KEY_FILE}
|
2020-09-17 14:18:44 +02:00
|
|
|
key_file: key.gpg
|
2021-04-08 20:15:11 +02:00
|
|
|
# PGP secret key id in hex format, if it is not set it will select the first subkey
|
|
|
|
# that has the signing flag set. You may need to set this if you want to use the primary key as the signing key
|
|
|
|
# or to support older versions of RPM < 4.13.0 which cannot validate a signed RPM that used a subkey to sign
|
|
|
|
# This will expand any env var you set in the field, eg key_id: ${RPM_SIGNING_KEY_ID}
|
|
|
|
key_id: bc8acdd415bd80b3
|
2020-09-17 14:18:44 +02:00
|
|
|
|
2020-11-03 13:44:59 +01:00
|
|
|
# Custom configuration applied only to the Deb packager.
|
2020-07-10 07:06:39 +02:00
|
|
|
deb:
|
2020-11-03 13:44:59 +01:00
|
|
|
# Custom deb special files.
|
2020-07-10 07:06:39 +02:00
|
|
|
scripts:
|
2020-11-03 13:44:59 +01:00
|
|
|
# Deb rules script.
|
2020-07-10 07:06:39 +02:00
|
|
|
rules: foo.sh
|
2020-11-03 13:44:59 +01:00
|
|
|
# Deb templates file, when using debconf.
|
|
|
|
templates: templates
|
2021-04-14 16:43:42 +02:00
|
|
|
# Deb config maintainer script for asking questions when using debconf.
|
|
|
|
config: config
|
2020-07-27 18:22:06 +02:00
|
|
|
|
|
|
|
# Custom deb triggers
|
|
|
|
triggers:
|
|
|
|
# register interrest on a trigger activated by another package
|
|
|
|
# (also available: interest_await, interest_noawait)
|
|
|
|
interest:
|
|
|
|
- some-trigger-name
|
|
|
|
# activate a trigger for another package
|
|
|
|
# (also available: activate_await, activate_noawait)
|
|
|
|
activate:
|
|
|
|
- another-trigger-name
|
2020-09-01 21:27:29 +02:00
|
|
|
|
|
|
|
# Packages which would break if this package would be installed.
|
|
|
|
# The installation of this package is blocked if `some-package`
|
|
|
|
# is already installed.
|
|
|
|
breaks:
|
|
|
|
- some-package
|
2020-09-17 14:18:44 +02:00
|
|
|
|
|
|
|
# The package is signed if a key_file is set
|
|
|
|
signature:
|
|
|
|
# PGP secret key (can also be ASCII-armored). The passphrase is taken
|
|
|
|
# from the environment variable $NFPM_DEB_PASSPHRASE with a fallback
|
2021-04-08 20:15:11 +02:00
|
|
|
# to $NFPM_PASSPHRASE.
|
2021-01-14 19:32:10 +01:00
|
|
|
# This will expand any env var you set in the field, eg key_file: ${SIGNING_KEY_FILE}
|
2020-09-17 14:18:44 +02:00
|
|
|
key_file: key.gpg
|
|
|
|
# The type describes the signers role, possible values are "origin",
|
|
|
|
# "maint" and "archive". If unset, the type defaults to "origin".
|
|
|
|
type: origin
|
2021-04-08 20:15:11 +02:00
|
|
|
# PGP secret key id in hex format, if it is not set it will select the first subkey
|
|
|
|
# that has the signing flag set. You may need to set this if you want to use the primary key as the signing key
|
|
|
|
# This will expand any env var you set in the field, eg key_id: ${DEB_SIGNING_KEY_ID}
|
|
|
|
key_id: bc8acdd415bd80b3
|
2020-09-17 14:18:44 +02:00
|
|
|
|
|
|
|
apk:
|
|
|
|
# The package is signed if a key_file is set
|
|
|
|
signature:
|
|
|
|
# RSA private key in the PEM format. The passphrase is taken from
|
|
|
|
# the environment variable $NFPM_APK_PASSPHRASE with a fallback
|
2021-04-08 20:15:11 +02:00
|
|
|
# to $NFPM_PASSPHRASE.
|
2021-01-14 19:32:10 +01:00
|
|
|
# This will expand any env var you set in the field, eg key_file: ${SIGNING_KEY_FILE}
|
2020-09-17 14:18:44 +02:00
|
|
|
key_file: key.gpg
|
|
|
|
# The name of the signing key. When verifying a package, the signature
|
|
|
|
# is matched to the public key store in /etc/apk/keys/<key_name>.rsa.pub.
|
|
|
|
# If unset, it defaults to the maintainer email address.
|
|
|
|
key_name: origin
|
2021-04-08 20:15:11 +02:00
|
|
|
# APK does not use pgp keys, so the key_id field is ignored.
|
|
|
|
key_id: ignored
|
2020-07-10 07:06:39 +02:00
|
|
|
```
|
|
|
|
|
|
|
|
## Templating
|
|
|
|
|
|
|
|
Templating is not and will not be supported.
|
|
|
|
|
|
|
|
If you really need it, you can build on top of NFPM, use `envsubst`, `jsonnet`
|
2020-07-10 07:16:16 +02:00
|
|
|
or apply some other templating on top of it.
|