Skip to content

Commit

Permalink
v10.0.0 release (#131)
Browse files Browse the repository at this point in the history
  • Loading branch information
san983 authored Jun 13, 2023
1 parent 1e6cae1 commit 2cdb4a0
Show file tree
Hide file tree
Showing 13 changed files with 56 additions and 33 deletions.
19 changes: 19 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,24 @@
# Changelog

## main

## [v10.0.0](https://github.com/dnsimple/chef-pdns/tree/v10.0.0) (2023-06-23)

[Full Changelog](https://github.com/dnsimple/chef-pdns/compare/v9.0.0...v10.0.0)

**Implemented enhancements:**

- Switch default to 4.8.x [\#130](https://github.com/dnsimple/chef-pdns/pull/130)
- Add Ubuntu v22.04 support [\#130](https://github.com/dnsimple/chef-pdns/pull/130)
- Drop Ubuntu v18.04 EOL support [\#130](https://github.com/dnsimple/chef-pdns/pull/130)
- Updates PowerDNS pubkey [\#130](https://github.com/dnsimple/chef-pdns/pull/130)

**Merged pull requests:**

- Deprecates Chef Delivery CLI usage [\#124](https://github.com/dnsimple/chef-pdns/pull/124)
- Have kitchen chef-client v18 [\#126](https://github.com/dnsimple/chef-pdns/pull/126)
- Bump nosborn/github-action-markdown-cli from 3.2.0 to 3.3.0 \#129](https://github.com/dnsimple/chef-pdns/pull/129)

## [v9.0.0](https://github.com/dnsimple/chef-pdns/tree/v9.0.0) (2021-10-29)

[Full Changelog](https://github.com/dnsimple/chef-pdns/compare/v6.1.1...v9.0.0)
Expand Down
2 changes: 1 addition & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ APPENDIX: How to apply the Apache License to your work.
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright (c) 2014-2021 DNSimple Corporation
Copyright (c) 2014-2023 DNSimple Corporation

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down
48 changes: 26 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@

Provides resources for installing and configuring both PowerDNS authoritative and recursor. It uses the official PowerDNS repositories for packages and installs the appropriate configuration for your platform's init system.

## Upgrade Notes for 10.x series

Please note that this version primarily supports PowerDNS 4.8 and PowerDNS Recursor 4.8. Older versions may work, but are not as heavily tested. Additionally support for Ubuntu 18.04 has been dropped.

## Upgrade Notes for 9.x series

Please note that this version primarily supports PowerDNS 4.5 and PowerDNS Recursor 4.5. Older versions may work, but are not as heavily tested.
Expand All @@ -21,7 +25,7 @@ Please note that this version primarily supports PowerDNS 4.3 and PowerDNS Recur

When upgrading to the 7.x series, please pay special attention to your config and service resources which use the run_user / run_group / setuid / setgid properties. We have removed these attributes to better match the direction of upstream PowerDNS.

## Ubuntu >=18.04 notes
## Ubuntu >= 18.04 notes

Operating systems like Ubuntu 18.04 and greater that ship with systemd-resolved configured to run by default will need this disabled and to manually configure your resolv.conf if you are running PowerDNS Authoritative on default ports.
You can look at the [test cookbook](https://github.com/dnsimple/chef-pdns/blob/master/test/cookbooks/pdns_test/recipes/disable_systemd_resolved.rb) for a simple example of how to handle this.
Expand All @@ -30,7 +34,7 @@ You can look at the [test cookbook](https://github.com/dnsimple/chef-pdns/blob/m

### Platforms

- Ubuntu 18.04 and newer
- Ubuntu 20.04 and newer
- Debian 9 and newer
- RHEL 7 and newer
- CentOS 7 and newer
Expand All @@ -53,12 +57,12 @@ Combine the different resources in order to install, configure, and manage your
| pdns_authoritative_config | Configures an authoritative instance |
| pdns_authoritative_service | Manages an authoritative instance |
| pdns_recursor_install | Installs a recusor |
| pdns_recursor_config | Configures a recursor instance  |
| pdns_recursor_config | Configures a recursor instance |
| pdns_recursor_service | Manages a a recursor instance |

To fully configure an authoritative server you need to add at least 3 resources to your recipe, `pdns_authoritative_install`, `pdns_authoritative_config` and `pdns_authoritative_service`. If you want to install any backend other than the default (bind) for the authoritative server you need to install the corresponding packages for the backend you want. There is an example for a postgresql backend in `test/cookbooks/pdns_test/recipes/`.

For a recursor use the `pdns_recursor_install`, `pdns_recursor_config`, and `pdns_recursor_service` resources in your wrapper cookbooks to install, configure, and define PowerDNS recursors. Set the different properties on the resources according to your install and configuration needs. You can see a good example of this in `test/cookbooks/pdns_test/recipes_recursor_install_single.rb`
For a recursor use the `pdns_recursor_install`, `pdns_recursor_config`, and `pdns_recursor_service` resources in your wrapper cookbooks to install, configure, and define PowerDNS recursors. Set the different properties on the resources according to your install and configuration needs. You can see a good example of this in `test/cookbooks/pdns_test/recipes_recursor_install_single.rb`

For advanced use it is recommended to take a look at the chef resources themselves.

Expand Down Expand Up @@ -112,14 +116,14 @@ Most of the properties are optional and have sane defaults, so they are only rec

### pdns_authoritative_install

Installs PowerDNS authoritative server 4.4.x series using PowerDNS official repository in the supported platforms.
Installs PowerDNS authoritative server 4.7.x series using PowerDNS official repository in the supported platforms.

#### pdns_authoritative_install Properties

| Name | Type | Default value |
|---------------|-------------|----------------|
| version | String | '' |
| series | String | '44' |
| series | String | '47' |
| debug | true, false | false |
| allow_upgrade | true, false | false |
| backends | Array | nil |
Expand All @@ -128,34 +132,34 @@ Installs PowerDNS authoritative server 4.4.x series using PowerDNS official repo

#### pdns_authoritative_install Usage examples

Install the latest 4.4.x series PowerDNS Authoritative Server
Install the latest 4.8.x series PowerDNS Authoritative Server

```ruby
pdns_authoritative_install 'server_01'
```

Install the latest 4.3.x series PowerDNS Authoritative Server
Install the latest 4.7.x series PowerDNS Authoritative Server

```ruby
pdns_authoritative_install 'server_01' do
series '43'
series '47'
end
```

Install and upgrade to the latest 4.4.x PowerDNS Authoritative Server release
Install and upgrade to the latest 4.8.x PowerDNS Authoritative Server release

```ruby
pdns_authoritative_install 'server_01' do
series '43'
series '47'
allow_upgrade true
end
```

Install the latest 4.4.x series PowerDNS Authoritative Server with the MySQL and Lua backends
Install the latest 4.8.x series PowerDNS Authoritative Server with the MySQL and Lua backends

```ruby
pdns_authoritative_install 'server_01' do
series '44'
series '48'
backends ['mysql', 'lua']
end
```
Expand Down Expand Up @@ -242,38 +246,38 @@ end

### pdns_recursor_install

Installs PowerDNS recursor 4.4.x series using PowerDNS official repository in the supported platforms.
Installs PowerDNS recursor 4.8.x series using PowerDNS official repository in the supported platforms.

#### pdns_recursor_install Properties

| Name | Type | Default value |
|----------------|-------------|-----------------|
| version | String | '' |
| series | String | '44' |
| series | String | '48' |
| debug | true, false | false |
| allow_upgrade | true, false | false |

#### pdns_recursor_install Usage examples

Install the latest 4.4.x release PowerDNS recursor
Install the latest 4.8.x release PowerDNS recursor

```ruby
pdns_recursor_install 'latest_4_3_x_recursor'
pdns_recursor_install 'latest_4_8_x_recursor'
```

Install the latest 4.3.x release PowerDNS recursor
Install the latest 4.7.x release PowerDNS recursor

```ruby
pdns_recursor_install 'my_recursor' do
series '43'
series '47'
end
```

Install and upgrade to the latest 4.4.x PowerDNS recursor release
Install and upgrade to the latest 4.8.x PowerDNS recursor release

```ruby
pdns_recursor_install 'my_recursor' do
series '44'
series '47'
allow_upgrade true
end
```
Expand Down Expand Up @@ -371,6 +375,6 @@ There is an specific file for testing guidelines on this cookbook: TESTING.md
## License

Copyright (c) 2010-2014, Chef Software, Inc
Copyright (c) 2014-2021, DNSimple Corporation
Copyright (c) 2014-2023, DNSimple Corporation

Licensed under the Apache License, Version 2.0.
2 changes: 1 addition & 1 deletion libraries/helpers.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Libraries:: helpers
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion metadata.rb
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
maintainer_email '[email protected]'
license 'Apache-2.0'
description 'Installs/Configures PowerDNS Recursor and Authoritative server'
version '9.0.0'
version '10.0.0'
source_url 'https://github.com/dnsimple/chef-pdns'
issues_url 'https://github.com/dnsimple/chef-pdns/issues'

Expand Down
2 changes: 1 addition & 1 deletion resources/authoritative_config.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_authoritative_config
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion resources/authoritative_install_debian.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_authoritative_install_debian
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion resources/authoritative_install_rhel.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_authoritative_install_rhel
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion resources/authoritative_service.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_authoritative_service
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion resources/recursor_config.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_recursor_config
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion resources/recursor_install_debian.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_recursor_install
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion resources/recursor_install_rhel.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_recursor_install
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down
2 changes: 1 addition & 1 deletion resources/recursor_service.rb
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
# Cookbook:: pdns
# Resources:: pdns_recursor_service
#
# # Copyright:: 2021, DNSimple Corp.
# # Copyright:: 2023, DNSimple Corp.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
Expand Down

0 comments on commit 2cdb4a0

Please sign in to comment.