From ca258fb77ea9eddb171d89dd7486c10469283043 Mon Sep 17 00:00:00 2001 From: Francesco Di Nucci Date: Thu, 28 Nov 2024 09:25:19 +0100 Subject: [PATCH 1/2] docs: 3.9 minimum Python version Puppetboard 6.0.0 drops Python 3.8 support --- README.md | 56 +++++++++++++++++++++++++++---------------------------- 1 file changed, 28 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index b84c9b0d..bf8d1749 100644 --- a/README.md +++ b/README.md @@ -9,22 +9,22 @@ #### Table of Contents -1. [Overview](#overview) -1. [Setup](#setup) - - [Installation](#installation) - - [Dependencies](#dependencies) -1. [Usage](#usage) -1. [Number of Reports](#number-of-reports) -1. [Offline Mode](#offline-mode) -1. [Set Default Environment](#set-default-environment) -1. [Disable SELinux Management](#disable-selinux-management) -1. [Apache](#apache) - - [Apache (with Reverse Proxy)](#apache-with-reverse-proxy) -1. [RedHat/CentOS 7 with Python 3](#redhatcentos-7-with-python-3) -1. [Using SSL to the PuppetDB host](#using-ssl-to-the-puppetdb-host) - - [Using SSL to PuppetDB >= 6.9.1](#using-ssl-to-puppetdb--691) -1. [Development](#development) - - [Authors](#authors) +- [Overview](#overview) +- [Setup](#setup) + - [Installation](#installation) + - [Dependencies](#dependencies) +- [Usage](#usage) +- [Number of Reports](#number-of-reports) +- [Offline Mode](#offline-mode) +- [Set Default Environment](#set-default-environment) +- [Disable SELinux Management](#disable-selinux-management) +- [Apache](#apache) + - [Apache (with Reverse Proxy)](#apache-with-reverse-proxy) +- [RedHat/CentOS 7 with Python 3](#redhatcentos-7-with-python-3) +- [Using SSL to the PuppetDB host](#using-ssl-to-the-puppetdb-host) + - [Using SSL to PuppetDB \>= 6.9.1](#using-ssl-to-puppetdb--691) +- [Development](#development) + - [Authors](#authors) ## Overview @@ -63,7 +63,7 @@ Declare the base puppetboard manifest with the below required parameter(s), set ```puppet class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), } ``` @@ -84,7 +84,7 @@ controlled to set the number of reports to show. ```puppet class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), reports_count => 40, } @@ -97,7 +97,7 @@ puppet board can load static assets (jquery, semantic-ui, tablesorter, etc) from ```puppet class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), offline_mode => true, } @@ -110,7 +110,7 @@ set to default to a different environment. ```puppet class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), default_environment => 'customers', } @@ -120,7 +120,7 @@ or to default to "All environments": ```puppet class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), default_environment => '*', } @@ -130,7 +130,7 @@ class { 'puppetboard': ```puppet class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), manage_selinux => false, } @@ -158,7 +158,7 @@ class { 'apache': # Configure Puppetboard class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), manage_virtualenv => true, } @@ -178,7 +178,7 @@ http://example.com/puppetboard: ```puppet # Configure Puppetboard class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), } @@ -258,7 +258,7 @@ Here's an example, using new certificates: $ssl_dir = '/var/lib/puppetboard/ssl' $puppetboard_certname = 'puppetboard.example.com' class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), manage_virtualenv => true, puppetdb_host => 'puppetdb.example.com', @@ -277,7 +277,7 @@ Here's a complete example, re-using the puppet client certs: $ssl_dir = $::settings::ssldir $puppetboard_certname = $::certname class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), manage_virtualenv => true, groups => 'puppet', @@ -295,7 +295,7 @@ Note that both the above approaches only work if you have the Puppet CA root cer $ssl_dir = $::settings::ssldir $puppetboard_certname = $::certname class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), manage_virtualenv => true, groups => 'puppet', @@ -318,7 +318,7 @@ that host and configure `puppetdb_host` to `127.0.0.1`: $ssl_dir = $::settings::ssldir $puppetboard_certname = $::certname class { 'puppetboard': - python_version => '3.8', + python_version => '3.9', secret_key => fqdn_rand_string(32), manage_virtualenv => true, groups => 'puppet', From 36e66df9ce01a20c5889c1f2ca95653c1a97cabf Mon Sep 17 00:00:00 2001 From: Francesco Di Nucci Date: Thu, 28 Nov 2024 09:28:20 +0100 Subject: [PATCH 2/2] docs: remove CentOS/RHEL 7 CentOS 7 reached EOL in 2024/06, RHEL 7 is in ELS, both ship only up to Python 3.8 - newer versions require manual install. Both have already been removed from metadata.json --- README.md | 9 --------- 1 file changed, 9 deletions(-) diff --git a/README.md b/README.md index bf8d1749..a0ddf834 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,6 @@ - [Disable SELinux Management](#disable-selinux-management) - [Apache](#apache) - [Apache (with Reverse Proxy)](#apache-with-reverse-proxy) -- [RedHat/CentOS 7 with Python 3](#redhatcentos-7-with-python-3) - [Using SSL to the PuppetDB host](#using-ssl-to-the-puppetdb-host) - [Using SSL to PuppetDB \>= 6.9.1](#using-ssl-to-puppetdb--691) - [Development](#development) @@ -225,14 +224,6 @@ apache::vhost { 'example.acme': } ``` -## RedHat/CentOS 7 with Python 3 - -CentOS/RedHat 7 is pretty old. Python 3 got added after the initial release and -a lot of packages are missing. For example python3.6 is available as a package, -but no matching wsgi module for apache is available. Because of that, we don't -test on CentOS 7 anymore. However, it's still possible to setup Puppetboard on -CentOS with gunicorn as a webserver and nginx/apache forwarding to it. - ## Using SSL to the PuppetDB host If you would like to use certificate auth into the PuppetDB service you must configure puppetboard to use a client certificate and private key.