Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

getssl (8) Versions 0.6.1

Installs/Configures getssl

Policyfile
Berkshelf
Knife
cookbook 'getssl', '~> 0.6.1', :supermarket
cookbook 'getssl', '~> 0.6.1'
knife supermarket install getssl
knife supermarket download getssl
README
Dependencies
Changelog
Quality 33%

getssl

Installs getssl, from https://github.com/srvrco/getssl, and configures it.

Finally a cron job will be created in order to execute the getssl -u -a -q
command daily at 5:23 AM.

This cookbook doesn't support ACL per domain's SANS, therefor is sets the
USE_SINGLE_ACL to true. That means the ACL will be used to validate the
domain and its sub-domains, which means the same server(s) is/are used to
validate both the root domain and its sub-domain.

Requirements

Platforms

  • Ubuntu 20.04 LTS

Chef

  • Chef >= 16

Attributes

So far this cookbook handles only one domain and only few options from
the getssl config files, just what we needed, but adding more is easy.

Have a look at the attributes file in order to see
what can be configured.

Usage

Add the getssl cookbook to your run_list.

Here is a very basic setup for the example.com domain:

default['getssl'] = {
  account: {
    email: 'youremail@domain.tld'
  },
  domain: {
    acl: [
      '/var/www/example.com/web/.well-known/acme-challenge'
    ],
    name: 'example.com',
    reload_cmd: 'systemctl restart nginx'
  }
}

With many web nodes

Given you have many nodes serving the traffic for the same domain name, getssl
will address the 2 issues that use case has:

  1. Making the challenge file available to all your nodes using the Acme Challenge Location (ACL)
  2. Copying the generated certificate files to all your nodes and reload/restart the web server

Acme Challenge Location (ACL)

You must define at least one, which is the local one to the current node being
converged by Chef.\
Then you can define additionnal ACLs to push the challenge file to your other
nodes through SSH/SFTP/FTPS:

default['getssl']['domain']['acl'] = [
  # First one is the local file location for the current node
  '/var/www/your_app/current/.well-known/acme-challenge',

  # Then your other nodes through SSH for example
  'ssh:admin@192.168.1.23:/var/www/your_app/current/.well-known/acme-challenge',
  'ssh:admin@192.168.1.24:/var/www/your_app/current/.well-known/acme-challenge'
]

See the getssl documentation or the attributes file
for more examples.

Copying the generated certificate files to all your nodes

After the challenge succeeded, you will need to get the certificate files being
copied to all your other nodes and the webserver being restarted/reloaded.

Here is how to configure the certificate files copying:

default['getssl']['domain']['key_location'] = [
  # First line for the current node
  '/etc/nginx/pki/private/server.key',

  # Then your other nodes through SSH for example
  'ssh:admin@192.168.1.23:/etc/nginx/pki/private/server.key',
  'ssh:admin@192.168.1.24:/etc/nginx/pki/private/server.key'
]

default['getssl']['domain']['chain_location'] = [
  # First line for the current node
  '/etc/nginx/pki/domain-chain.crt',

  # Then your other nodes through SSH for example
  'ssh:admin@192.168.1.23:/etc/nginx/pki/domain-chain.crt',
  'ssh:admin@192.168.1.24:/etc/nginx/pki/domain-chain.crt'
]

Here is how to configure the local and remote reload of the web server:

default['getssl']['domain']['reload_cmd'] = [
  # First line for the current node
  'systemctl reload nginx',

  # Then your other nodes through SSH for example
  'ssh:admin@192.168.1.23:systemctl reload nginx',
  'ssh:admin@192.168.1.24:systemctl reload nginx'
]

Hey! Automation now!

Okay so quite boring to repeat those IP addresses and/or adding new nodes
manually ?
Are you looking for an automated way of doing this ?

After all, it's Chef !

Given all your nodes are identical (same apps, same pathes for files), then just
define the first line only, and set
the default['getssl']['domain']['auto'] = true attribute and this cookbook
will build the lines for all your nodes (searched from your chef repository)
having this cookbook in their run_list:

default['getssl'] = {
  account: {
    email: 'youremail@domain.tld'
  },
  domain: {
    acl: [
      '/var/www/example.com/web/.well-known/acme-challenge'
    ],
    auto: true,
    chain_location: '/etc/nginx/pki/domain-chain.crt',
    key_location: '/etc/nginx/pki/private/server.key',
    name: 'example.com',
    reload_cmd: 'systemctl reload nginx'
  }
}

And Voila, your other nodes will be included automatically in the acl and
reload_cmd attribute at runtime, so don't forget to converge all your nodes so
that each nodes know about the others and have a complete list to copy/restart.

Recipes

recipe[rvm_io::default] # Install, configure getssl and create a cron job

Author

Hydrana SAS

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

getssl-cookbook CHANGELOG

This file is used to list changes made in each version of the getssl-cookbook cookbook.

Unreleased

0.6.1

  • Sets the domain's USE_SINGLE_ACL to true

0.6.0

  • Adds the default['getssl']['domain']['sans'] attribute

0.5.0

  • Adds the default['getssl']['domain']['full_chain_include_root'] attribute

0.4.1

  • Fixes Let's Encrypt URLs

0.4.0

  • Adds the default['getssl']['domain']['remote_user'] attribute used in auto mode in order set the remote user to be used to copy files or running commands remotely

0.3.0

  • Fixes ACL variable content in auto mode
  • Adds SCP_OPTS and SFTP_OPTS

0.2.0

Prevents from re-downloading getssl (prefer the script's auto-update feature)

0.1.0

Initial release.

Collaborator Number Metric
            

0.6.1 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

0.6.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file

Foodcritic Metric
            

0.6.1 passed this metric

No Binaries Metric
            

0.6.1 passed this metric

Testing File Metric
            

0.6.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

0.6.1 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number