A tool to automatically sync certificates and update services.
Project description
certdeploy
A tool to automatically sync certificates and update services.
This tool has two parts:
- The "server". Which is implemented as a deploy hook for certbot and a docker container that bundles the deploy hook with certbot.
- The "client". Which when run as a script moves certs from a staging directory to another directory, updates services after it moves the certs and can be run via cron or systemd timer and the "client" daemon which also runs an SFTP server that the CertDepoly server can connect to directly.
This tool can be used in a few different ways:
- As a set of docker containers automatically renewing and distributing certs then updating docker services and restarting docker containers via the Docker API.
- As scripts embeded in regular linux systems.
- As a mix of both.
The Server
There are three parts to the server.
- The certbot hook, which is run by Certbot as a deploy hook. This queues updates to be pushed to clients.
- The command, which can be used to push certs to clients directly or try to renew certs immediately. This is useful for testing setups.
- The daemon, which runs
certbot renew
on an interval (and indirectlycertdeploy-server
as a hook when certs are renewed). It also processes the push queue. This is optional, but is the default in the server docker container.
Commandline Options for the command/daemon
--config
- The path to the config file. Defaults to/etc/certdeploy/server.yml
.--daemon
- Run the daemon. Without this option the server command will run once and exit.--domains
- A space separated list of domains as a single string (eg"www.example.com example.com"
). This is mutually exclusive with--daemon
.--lineage
- The path of a lineage (eg/etc/letsencrypt/live/example.com
). This is mutually exclusive with--daemon
.--log-filename
- Set the log file location. Defaults to the configuredlog_filename
.--log-level
- Set the log level toDEBUG
,INFO
,WARNING
,ERROR
, orCRITICAL
. Defaults to the configuredlog_level
.--push
- Run the daemon only until the queue is empty and all pushes have been processed. When used with--lineage
and--domains
it populates the queue and then runs the daemon until the push is complete.--renew
- Run the cert renewal part of the daemon once and exit.--sftp-log-filename
- Set the SFTP client log file location. Defaults to the configuredsftp_log_filename
.--sftp-log-level
- Set the SFTP client log level toDEBUG
,INFO
,WARNING
,ERROR
, orCRITICAL
. Defaults to the configuredsftp_log_level
.
Examples
To run these in the running docker container prefix the commands with docker container exec <container name>
.
- Run the daemon with a custom config file location and log level.
certdeploy-server --daemon --config /path/to/server.yml --log-level INFO
- Run the command to force deploying certs. Where
/etc/letsencrypt/live/
is the path to the lineages. Certbot puts it there by default. The server script can only handle one lineage at a time.certdeploy-server --push --lineage /etc/letsencrypt/live/example.com --domains "www.example.com example.com"
- Run the command to try to renew certs. This will not cause the certs to be pushed to clients unless the daemon is running or is run after the CertDeploy deploy hook is run.
certdeploy-server --renew
- Run the command to push an existing push queue, but without adding to the queue.
certdeploy-server --push
Enviroment Variables
Commandline options override environment variables.
CERTDEPLOY_SERVER_CONFIG
- The path to the server config file. Equivalent to--config
.CERTDEPLOY_SERVER_DAEMON
- If set totrue
it is the equivalent of--daemon
.CERTDEPLOY_SERVER_LOG_FILENAME
- The path to the server log file. Equivalent to--log-filename
.CERTDEPLOY_SERVER_LOG_LEVEL
- The log level. Equivalent to--log-level
.CERTDEPLOY_SERVER_RENEW_ONLY
- If set totrue
it is the equivalent of--renew
.CERTDEPOLY_SERVER_PUSH_ONLY
- If set totrue
it is the equivalent of--push
. This overridesCERTDEPLOY_SERVER_DAEMON
and--daemon
so that the docker container respects this environment variable.CERTDEPOLY_SERVER_SFTP_LOG_FILENAME
- The log path for the SFTP client. Equivalent to--sftp-log-filename
.CERTDEPOLY_SERVER_SFTP_LOG_LEVEL
- The log level of the SFTP client. Equivalent to--sftp-log-level
.
Hook Environment Variables
The hook (certdeploy-server
when it's run by Certbot) expects the following environmental variables from Certbot in addition to the optional CERTDEPLOY_SERVER_CONFIG
and CERTDEPLOY_SERVER_LOG_LEVEL
as described above.
RENEWED_LINEAGE
- The "lineage" or path to the renewed certs.RENEWED_DOMAINS
- A space separated list of domains associated to the renewed certs.
Configuration
Server Settings
privkey_filename
- The path to the CertDeploy server private key file.client_configs
(optional) - A list of client connection settings.client_config_directory
(optional) - A directory containing files with one set of client connection settings.fail_fast
(optional) - Stop on the first failed action. Defaults tofalse
.log_level
(optional) - The logging level. Options areDEBUG
,INFO
,WARNING
,ERROR
,CRITICAL
. Defaults toERROR
.log_filename
(optional) - The path to the log file. Defaults to the default global log file (/dev/stdout
).sftp_log_level
(optional) - The SFTP client logging level. Options areDEBUG
,INFO
,WARNING
,ERROR
,CRITICAL
. Defaults toERROR
.sftp_log_filename
(optional) - The path to the SFTP client log file. Defaults to the default global log file (/dev/stdout
).
The following are daemon specific configs.
renew_every
(optional) - The interval count to multiplyrenew_unit
by. This must be a positive integer. The default is1
.renew_unit
(optional) - The interval unit to check for new certs. This can beminute
,day
,week
, or a weekday. Defaults today
.renew_at
(optional) - The time of day to check for new certs. FormattedHH:MM
. Defaults tonull
which is equivalent to the current time.renew_exec
(optional) - The path of thecertbot
executable. If for some reasoncertbot
isn't in the$PATH
this lets the full path be given. This is also useful for testing. A script that touches a flag file or does a web request when run can be mounted in the container and the path given with this option. That way settings can be tested without spamming Let's Encrypt.renew_args
(optional) - A list of arguments to pass tocertbot
when attempting to renew certs. Defaults to['renew']
.push_mode
(optional) - The mode used to push certs to clients. This must beserial
orparallel
. Defaults toserial
.push_interval
(optional) - The number of seconds to wait between pushing to clients. This must be a positive integer or0
.0
disables the delay. Defaults to0
.push_retries
(optional) - The number of times to retry pushing certs to clients. This must be a positive integer or0
.0
disables retries. Defaults to1
(one initial attempt and one retry). This can be overridden by the same setting in client connection configs.push_retry_interval
(optional) - The delay in seconds between retrying to push certs to clients. This must be an positive integer or0
.0
disables the delay between retries. Defaults to30
. This can be overridden by the same setting in client connection configs.join_timeout
(optional) - The number of seconds to wait while joining push threads. This must be a positive number ornull
.null
disables the timeout. Defaults tonull
. Set this to help identify the cause of hung pushes.queue_dir
(optional) - The directory where the queue and the lock file will be stored. Defaults to/var/run/certdeploy
.
Scheduling Examples
-
The default behavior is to try to renew once a day which is equivalent to the following.
renew_every: 1 renew_unit: day renew_at: null
-
To try to renew certs every other day at 3pm use the following.
renew_every: 2 # ``day`` is the default for `renew_unit` so this can be left out if you want. renew_unit: day renew_at: 15:00
-
To try to renew certs every Monday and you don't care about the time use the following.
renew_unit: monday
Push Retry Examples
-
Wait 30 seconds between initial attempts to push to clients.
push_interval: 30
-
Retry pushing to clients after an hour (
3600
seconds).push_retry_interval: 3600
-
Retry pushing to clients after an hour and retry every hour twelve times.
push_retry_interval: 3600 push_retries: 12
Client Connection Settings
address
- The client address (IP address or hostname).domains
- A list of domains that this client needs certs for.pubkey
- The text of the client's public key. If the client is a regular SSH server remember to grab the SSH server's pubkey not the user's pubkey.port
(optional) - The remote port of either an ssh server on the client or the CertDeploy client. Defaults to22
.username
(optional) - The remote username to login to the ssh server or CertDeploy client with. Defaults tocertdeploy
.path
(optional) - The directory on the remote system where the CertDeploy client will look for new certs. Defaults to/var/cache/certdeploy
. If set tonull
or an empty string the base path for the client will be used. This will be the configuredsource
path on the client daemon or the home directory if the client is relying on the host system for SFTP. This directory should only be readable by the CertDeploy user on the client since it will have TLS certs hanging around.needs_chain
(optional) - If this istrue
thechain.pem
from the relevant lineages will be copied to this client. Defaults tofalse
.needs_fullchain
(optional) - If this istrue
thefullchain.pem
from the relevant lineages will be copied to this client. Defaults totrue
.needs_privkey
(optional) - If this istrue
theprivkey.pem
from the relevant lineages will be copied to this client. Defaults totrue
.push_retries
(optional) - The number of times to retry connecting to this client. This must be a positive integer or0
if set. If set, it overrides the server'spush_retries
value for this client.0
will cause the server to only try to push once (no retries). Defaults tonull
.push_retry_interval
(optional) - The interval in seconds to wait between retries for this client. This must be a positive integer or0
if set. If set, it overrides the server'spush_retry_interval
value for this client. Defaults tonull
.
Client Connection Examples
-
Override the push retries and retry interval for just one client.
client_configs: - address: 1.2.3.4 pubkey: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIP+H3Nk/9uSa7LHNt8fvCPKKkNFnVE5SGC5tnthf6/OK domains: - example.com push_retries: 42 push_retry_interval: 3600 - address: 5.6.7.8 pubkey: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEuhX3Q690lnBhpfGHOs0j4CuCxE3E3jekWehvHRmVKt domains: - example.net
-
A file in
client_config_directory
.address: 1.2.3.4 pubkey: ssh-ed25519 aaaac3nzac1lzdi1nte5aaaaip+h3nk/9usa7lhnt8fvcpkkknfnve5sgc5tnthf6/ok domains: - example.com
Examples
Simple
A single client and private key. This will work in any of the server modes.
---
privkey_filename: /etc/certdeploy/server_key
client_configs:
- address: 1.2.3.4
pubkey: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIP+H3Nk/9uSa7LHNt8fvCPKKkNFnVE5SGC5tnthf6/OK
domains:
- example.com
Daemon
This can be given to certdeploy-server
along with the --daemon
option or as part of the docker image to run certbot renew
every Monday at 9:00AM and deploy new certs for example.com
to 1.2.3.4
.
---
privkey_filename: /etc/certdeploy/server_key
renew_every: monday
renew_at: 09:00
client_configs:
- address: 1.2.3.4
pubkey: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIP+H3Nk/9uSa7LHNt8fvCPKKkNFnVE5SGC5tnthf6/OK
domains:
- example.com
Server Security Considerations
When run as a script (--renew
) or daemon outside of docker it's expected that the CertDeploy server will run as root or a user that has permission to run certbot renew
. Because it can run arbitrary code (via the renew_exec
and renew_args
configs) and distributes your TLS certs, it is very strongly recommended that the config file is globally read only or readable only by the user running the server, and writable only by root or at most only by the user that runs the server. Similarly (but less so) the push queue can be used to force the server to push certs or files that are where the given lineage should be. Putting the queue file in a place where other users can get to it doesn't directly create a security hole but it can be combined with other potential problems to distribute or exfiltrate data.
Installation
The recommended way to use the server is to have it running in a docker container. The server image has Certbot baked in and automatically runs certbot renew
on a schedule.
Docker
-
Create a directory to put the configs in and enter it. For example
mkdir conf && cd conf
. -
Generate server key pair
ssh-keygen -t ed25519 -f server_key
Don't enter a password. CertDeploy doesn't support password files. -
Create a
server.yml
with the clients. For now we'll assume you have the public key for the first client.--- private_key_file: /etc/certdeploy/server_key client_configs: - address: <your client ip or hostname> pubkey: <your client's public key without the comment> domains: - <the domain name that this client needs certs for> check_renew: every: week
-
Install the docker container.
docker run -d -v $(pwd)/conf:/etc/certdeploy -v /etc/letsencrypt:/etc/letsencrypt haxwithaxe/certdeploy-server
Where
./conf
is a directory with aserver.yml
and an ED25519 key pair. If you don't see anything in the logs it's probably working fine. The default log level isn't verbose. You can add--env 'CERTDEPLOY_SERVER_LOG_LEVEL=DEBUG'
to get the firehose of output if you want to be certian it's working.Or with docker-compose with the following:
--- version: "3" services: certdeploy-server: image: haxwithaxe/certdeploy-server volumes: - "./conf:/etc/certdeploy" - "/etc/letsencrypt:/etc/letsencrypt"
Install In An Existing System
-
Create a directory to put the configs in and enter it. For example
sudo mkdir /etc/certdeploy && cd /etc/certdeploy
. -
Generate server key pair
sudo ssh-keygen -t ed25519 -f server_key
Don't enter a password. CertDeploy doesn't support password files. -
Create a
server.yml
with the clients. For now we'll assume you have the public key for the first client.--- private_key_file: /etc/certdeploy/server_key client_configs: - address: <your client ip or hostname> pubkey: <your client's public key without the comment> domains: - <the domain name that this client needs certs for> check_renew: every: week
-
Install CertDeploy
sudo pip install certdeploy
. -
Install the CertDeploy CertBot hook.
sudo ln -s /usr/local/bin/certdeploy-server /etc/letsencrypt/renewal-hooks/deploy/certdeploy-hook
The Client
Commandline Options
--config
- The path to the config file. Defaults to/etc/certdeploy/client.yml
.--daemon
- Run the daemon. Without this option the sync and update actions will run once and quit.--log-filename
- Set the log file location. Defaults to the configuredlog_filename
.--log-level
- Set the log level toDEBUG
,INFO
,WARNING
,ERROR
, orCRITICAL
. Defaults to the configuredlog_level
.--sftp-log-filename
- Set the SFTP server log file location. Defaults to the configured (SFTP)log_filename
.--sftp-log-level
- Set the SFTP server log level toDEBUG
,INFO
,WARNING
,ERROR
, orCRITICAL
. Defaults to the configured (SFTP)log_level
.
Environment Variables
Commandline options override environment variables.
CERTDEPLOY_CLIENT_CONFIG
- The path to the client config file. Equivalent to--config
.CERTDEPLOY_CLIENT_DAEMON
- If set totrue
it is the equivalent of--daemon
.CERTDEPLOY_CLIENT_LOG_FILENAME
- The path to the client log file. Equivalent to--log-filename
.CERTDEPLOY_CLIENT_LOG_LEVEL
- The client log level. Equivalent to--log-level
.CERTDEPOLY_CLIENT_SFTP_LOG_FILENAME
- The log path for the SFTP server. Equivalent to--sftp-log-filename
.CERTDEPOLY_CLIENT_SFTP_LOG_LEVEL
- The log level of the SFTP server. Equivalent to--sftp-log-level
.
Configuration
Generate Client Key Pair
ssh-keygen -t ed25519 -f client_key
Don't enter a password. CertDeploy doesn't support password files.
Client Settings
destination
- The path to dump the certs in. The certs will be placed in "lineage" directories within this directory as seen in/etc/letsencrypt/live
in a certbot installation.update_sevices
- A list of definitions of services to reload/restart/run after deploying the certs. See Service Definitions.source
(optional) - The directory the server uploads the certs to. Defaults to/var/cache/certdeploy
.sftpd
(optional) - The SFTP server settings. See Daemon Specific Settings.systemd_exec
(optional) - The path to thesystemctl
executable for restarting/reloading Systemd units.systemd_timeout
(optional) - The timeout in seconds for executing systemctl commands. Defaults tonull
(wait indefinitely).docker_url
(optional) - The URL to the Docker API. Defaults to the local socket location.log_level
(optional) - The logging level. Options areDEBUG
,INFO
,WARNING
,ERROR
,CRITICAL
. Defaults toERROR
.log_filename
(optional) - The path to the log file. Defaults to the default global log file (/dev/stdout
).file_permissions
(optional) - The permissions to set the cert files and lineage directories to indestination
. By default the permissions are not actively set by the client. The CertDeploy server (SFTP client) sets the permissions with the attributes of the files from the lineage directory when it transfers them and the client moves the files that were transfered without altering the permissions. See File Permissions
This is an example of a hyper simple cron job or Systemd timer run client config that just moves the certs and doesn't restart any services. It just moves certificates from the default source
to destination
.
destination: /etc/letsencrypt/live
In a case like this the certs are delivered via whatever ssh server is running on the client host and the certdeploy-client
script is run as a user with permission to write to the destination directory (probably root). See the this section for more info and security considerations.
Service Definitions
Each definition has a type
key and one or more other keys. They are run in the order they are written in the config.
- Docker swarm services have a
type
ofdocker_service
and can have aname
key with a string value or afilters
key with a dictionary of filters. See Docker Services and Containers. - Docker containers have a
type
ofdocker_container
and can have aname
key with a string value or afilters
key with a dictionary of filters. See Docker Services and Containers. - Systemd units have a
type
ofdocker_service
, aname
key with the unit name, and optionally anaction
key that can be eitherrestart
orreload
. Thename
is the full unit names (with the unit type extension egnginx.service
). The value ofaction
corresponds to the systemctl arguments. See Systemd Units. - Arbitrary scripts have the
type
script
and aname
key with the path of the script to execute. See Scripts.
Service settings
Docker Services and Containers
The two config fields for each docker service or container are name
and filters
. Either name
or filters
can be given.
update_services:
- type: docker_container
name: ingress_nginx
- type: docker_service
filters:
label:
- restart_on_cert_update
- type: docker_container
name: web_nginx_1
- type: docker_container
filters:
name: web_traefik_1
The first of the example definitions is equivalent to the following:
update_container:
- type: docker_container
filters:
name: "^ingress_nginx$"
For docker containers the name is automatically converted into a filter for the exact match if no filters are given.
Due to the bug docker services the name is used to get the container directly whether filters
are set or not.
WARNING
Due to a docker bug filters for docker services don't work as expected at release time. Any regex will cause a failure to match. Plain old substring matching works fine so filters: { label: [ foo ] }
will still match services with 'foo' in the keys any of their labels but filters: { label: [ ^foo ] }
or filters: { label: [ foo.* ] }
will not match any services even if there are services that match those criteria.
Scripts
The only option for scripts is name
which is the path to the script.
name
can be an absolute path, an executable in the system's $PATH
, or relative path (complicated). The path is evaluated in that order.
The relative path is relative to the current working directory which is different depending on how the client is being run.
update_services:
- type: script
name: script_in_path.sh
- type: script
name: /path/to/script.sh
Systemd Units
The two config fields for each Systemd service are name
and action
. action
can be restart
or reload
which correspond to the systemctl restart ...
and systemctl reload ...
commands. The default action
is restart
.
update_services:
- type: systemd
name: nginx_or_whatever.service
- type: systemd
name: apache_or_whatever.service
action: reload
File Permissions
These are the permissions to set the cert files and lineage directories to in the destination
directory. All options are optional. Any combination of options is valid.
mode
(optional) - The file mode in an octal string or as a base10 integer. A safe value is0o600
(only the owner can read or write the certificates) For example the following are valid and equivalent:'0o600'
- A string with an octal prefix.'0600'
- A plain octal string. The sticky bit is not used but if it's given and is0
it's ignored.384
- As a base10 integer.
directory_mode
(optional) - The mode for the lineage directory. Same criteria asmode
, just don't forget to set the execute bit for the relevant parts. A safe value is0o700
(only the owner is allowed to read write and enumerate the directory).owner
(optional) - The owner's UID or username. This defaults to the user the client is run as.group
(optional) - The group's GID or group name. This defaults to the primary group user the client is run as or the GID set for the process when running the client.
By default the permissions are not actively set by the client. The CertDeploy server (SFTP client) sets the permissions with the attributes of the files from the lineage directory when it transfers them and the client moves the files that were transferred without altering the permissions.
Example
This example sets the permissions of the lineage directory and certs to the defaults assuming the certs originated from the certbot managed letsencrypt directory and the CertDeploy client is running as root.
...
file_permissions:
mode: 0o600
directory_mode: 0o700
owner: root
group: root
...
File Permissions Security Considerations
Nothing more than the usual precautions for letsencrypt certs.
- Avoid setting the rightmost bit to anything but
0
. These permissions are for files that shouldn't be accessible to anyone that doesn't absolutely need to read them. - Avoid setting the owner or group to
nobody
(UID65534
) as it's often oversubscribed by other services. If you need to set user or group to something other thanroot
try to use a UID and GID that aren't used by other processes on the system and add the users that need access to the certs to the unique group.
Daemon Specific Settings
The sftpd
section contains the settings for the SFTP server that accepts incoming certs from the CertDeploy server.
privkey_filename
- The path to the CertDeploy client (SFTP server) private key file.server_pubkey
- The text of the remote CertDeploy server (SFTP client) public key. This is optional ifserver_pubkey_filename
is given and is overridden byserver_pubkey_filename
.server_pubkey_filename
- The path to the remote CertDeploy server (SFTP client) public key file. This is optional ifserver_pubkey
is given.listen_port
(optional) - The port the CertDeploy client (SFTP server) listens on. Defaults to22
.listen_address
(optional) - The address the CertDeploy client (SFTP server) listens on. Defaults to listening on all interfaces (literally''
but equivalent to0.0.0.0
).username
(optional) - The username to require the CertDeploy server to login with. Defaults tocertdeploy
.log_level
(optional) - The SFTP server log level. The options areDEBUG
,INFO
,WARNING
,ERROR
,CRITICAL
. Defaults toERROR
.log_filename
(optional) - The log file for the SFTP server. Defaults to the global default (/dev/stdout
).
Example snippet:
sftpd:
listen_port: 33774
privkey_filename: /etc/certdeploy/client_key
server_pubkey_filename: /etc/certdeploy/server_key.pub
Full Client Config Example
This config accepts new certs via SFTP into the default source directory. Moves them to the given destination directory. Then updates services. It restarts the nginx systemd service. It runs two scripts. It restarts a docker container. It force-updates docker swarm services based on two sets of filters. Logs CertDeploy logs at DEBUG
level to /dev/stdout
and SFTP logs to /dev/stderr
at CITICAL
level. It also sets the mode of the lineage directories to 0o700
and certs to Oo600
all owned by root when the certs are deployed to the destination
directory.
The updates aren't guaranteed to be in any given order for now. The plan is to make the order something users set.
---
destination: /etc/letsencrypt/live
update_services:
- type: systemd
name: nginx.service
- type: script
name: touch-flag-file.sh
- type: script
name: poke-the-custom-server.sh
- type: docker_container
name: internal_traefik_1
- type: docker_service
filters:
label:
- restart_on_cert_update
log_filename: /dev/stdout
log_level: DEBUG
file_permissions:
mode: 0o600
directory_mode: 0o700
owner: root
group: root
sftpd:
listen_port: 33774
privkey_filename: /etc/certdeploy/client_key
server_pubkey_filename: /etc/certdeploy/server_key.pub
log_filename: /dev/stderr
log_level: CRITICAL
Client Security Considerations
When run as a script or daemon outside of docker it's expected that the CertDeploy client will run as root or a user that has permission to manage system services and docker. Because it can run arbitrary code (via the script
service definitions) it is very strongly recommended that the config file and the update scripts are globally read only or readable only by the user that runs the client, and writable only by root or at most only the user that runs the client. See also File Permissions.
Installation
Cron Job
-
Create a config directory
mkdir /etc/certdeploy
. -
Create a config in
/etc/certdeploy/client.yml
.--- source: /var/cache/certdeploy destination: /etc/letsencrypt/live update_services: <put your service definitions here>
-
Ensure your
source
directory exists, is owned by the user the client is running as, and that only that user can read the contents of that directory. -
Ensure the
destination
directory exists and is writable by the user the client is running as. -
Add a cron entry that runs the
certdeploy-client
at whatever frequency you want.@daily /usr/bin/certdeploy-client
Daemon
-
Create a config directory
mkdir /etc/certdeploy
. -
Generate a client key pair
ssh-keygen -t ed25519 -f /etc/certdeploy/client_key
. Don't enter a password. CertDeploy doesn't support password files. -
Create a config in
/etc/certdeploy/client.yml
.--- source: /var/cache/certdeploy destination: /etc/letsencrypt/live update_services: <put your service definitions here> sftpd: listen_port: 33774 privkey_filename: /etc/certdeploy/client_key server_pubkey_filename: /etc/certdeploy/server_key.pub
-
Ensure your
source
directory exists, is owned by the user the client is running as, and that only that user can read the contents of that directory. -
Ensure the
destination
directory exists and is writable by the user the client is running as. -
Start the daemon.
certdeploy-client --daemon
Systemd Daemon
To run the client as a daemon with systemd the following example unit can be used.
/usr/local/lib/systemd/system/certdeploy-client.service
[Unit]
Description=Certdeploy Client Daemon
After=network.target
[Service]
Type=exec
ExecStart=/usr/local/bin/certdeploy-client --daemon
[Install]
WantedBy=multi-user.target
The instructions above for configuring the daemon apply here. Except for the Start the daemon step which should be replaced with the following commands.
systemctl enable certdeploy-client.service
systemctl start certdeploy-client.service
Systemd Timer
If only syncronization between directories is needed these two systemd units can be used to run the client as a script every hour.
/usr/local/lib/systemd/system/certdeploy-client.service
[Unit]
Description=Certdeploy Client
After=network.target
[Service]
Type=oneshot
ExecStart=/usr/local/bin/certdeploy-client
/usr/local/lib/systemd/system/certdeploy-client.timer
[Unit]
Description=CertDeploy Client Timer
[Timer]
OnUnitActiveSec=1h
Unit=certdeploy-client.service
[Install]
WantedBy=timers.target
The instructions in the Cron Job section above can be followed until the Add a cron entry ... step which should be replaced with the following.
systemctl enable certdeploy-client.timer
Docker
-
Create a config directory
mkdir conf
. -
Generate a client key pair
ssh-keygen -t ed25519 -f conf/client_key
. Don't enter a password. CertDeploy doesn't support password files. -
Create a config in
conf/client.yml
.--- source: /certdeploy/staging destination: /certdeploy/certs update_delay: 10m update_services: <put your service definitions here> sftpd: listen_port: 33774 privkey_filename: /etc/certdeploy/client_key server_pubkey_filename: /etc/certdeploy/server_key.pub
-
Start the daemon.
docker run -d -v $(pwd)/conf:/etc/certdeploy -v shared_certs:/certdeploy/certs haxwithaxe/certdeploy-client
Where
shared_certs
is a docker volume shared with other containers that need access to the certs.Or with docker-compose using this:
--- version: "3" services: certdeploy-client: image: haxwithaxe/certdeploy-client volumes: - "./conf:/etc/certdeploy" - "shared_certs:/certdeploy/certs"
Note
This project has been set up using PyScaffold 4.3. For details and usage information on PyScaffold see https://pyscaffold.org/.
Project details
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 Distribution
Built Distribution
Hashes for certdeploy-0.4.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b9f2f6be5359f4d4170e7e52c95562485e30cae400ff80f370d6fe82fa7e0b68 |
|
MD5 | 3d1a79e07af6bcb6d51dcfbcea9c0390 |
|
BLAKE2b-256 | 48c2874d8d0dda676cd1e73951c05193616bb36a08a10ba2047282f2277fcff6 |