From bae294932e9e9eb0ecd174dc1f876ddac676c764 Mon Sep 17 00:00:00 2001 From: MSK Date: Mon, 7 Sep 2020 23:22:55 +0100 Subject: [PATCH] docs: release v3.0.0 --- CHANGELOG.md | 33 +++++++++++++++++++++++++++------ README.md | 29 +++++++++++++++++------------ setup | 3 +++ 3 files changed, 47 insertions(+), 18 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 8d5418e..c6a091d 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,6 +1,21 @@ # Changelog -## [Unreleased][unreleased] - 2020-09-05 +## [Unreleased][unreleased] + +Unreleased changes in the `develop` and `feature/*` branches. + +[unreleased]: https://github.com/markosamuli/linux-machine/commits/develop + +## [3.0.0] - 2020-09-07 + +Release targeting [Ubuntu 20.04 LTS (Focal Fossa)][focal] and +[Debian buster][buster] releases running on +[Window Subsystem for Linux (WSL) 2][wsl2]. + +[focal]: https://releases.ubuntu.com/focal/ +[buster]: https://www.debian.org/releases/buster/ +[wsl2]: https://docs.microsoft.com/en-gb/windows/wsl/wsl2-index +[3.0.0]: https://github.com/markosamuli/linux-machine/releases/tag/v3.0.0 ### Breaking changes @@ -25,6 +40,10 @@ - Install Zsh +#### Debian + +- Support for configuring Debian environments + #### Go Install additional Go tools for development: @@ -65,7 +84,8 @@ Install additional Go tools for development: #### Security - Install [ClamAV][clamav] antivirus software -- Install [Lynis][lynis] security tool for auditing the system +- Install [Lynis][lynis] v3.0.0 security tool for auditing the system +- Lynis custom configuration for WSL environments [clamav]: https://www.clamav.net/ [lynis]: https://cisofy.com/lynis/ @@ -95,8 +115,7 @@ Optional system monitoring tools: #### Configuration -- Added my Linux configuration file `machine.msk.yaml` -- Added my WSL configuration file `machine.wsl.yaml` +- Added my Linux configuration file [`machine.msk.yaml`](machine.msk.yaml) ### Changed @@ -198,6 +217,7 @@ Fixes in the development tools: - Prevent [pre-commit] from being upgraded to version 2 - Suppress errors in `Makefile` when `pyenv` is not installed +- Ignore Python 3.8.0 when creating virtualenv for local development ### Removed @@ -206,6 +226,8 @@ Fixes in the development tools: ## [2.0.0] - 2019-11-24 +[2.0.0]: https://github.com/markosamuli/linux-machine/releases/tag/v2.0.0 + ### Added - Fix permissions in user home directory @@ -276,6 +298,7 @@ Fixes in the development tools: environment variable. - Added support for uninstalling existing Ansible installations. - Added new long command line options in the setup script. +- Import setup script improvements from the `macos-machine` repository. #### Default installation options @@ -408,6 +431,4 @@ symbolic links to `/usr/local/bin`. These will be removed automatically. First release. -[unreleased]: https://github.com/markosamuli/linux-machine/commits/develop -[2.0.0]: https://github.com/markosamuli/linux-machine/releases/tag/v2.0.0 [1.0.0]: https://github.com/markosamuli/linux-machine/releases/tag/v1.0.0 diff --git a/README.md b/README.md index a8303a1..c96b2c8 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ Read my [Machine Setup Guide][machine-setup-guide] for instructions. ## Requirements -- [Ubuntu][ubuntu] or another supported operating system +- [Ubuntu][ubuntu] or [Debian][debian] Linux - Git installed - Bash shell - [Ansible][ansible] 2.8 or newer @@ -33,23 +33,27 @@ Read my [Machine Setup Guide][machine-setup-guide] for instructions. See [markosamuli/macos-machine] for my macOS setup. [ubuntu]: https://www.ubuntu.com -[ansible]: https://www.ansible.com/ +[debian]: https://www.debian.org +[ansible]: https://www.ansible.com [markosamuli/macos-machine]: https://github.com/markosamuli/macos-machine ### Ubuntu -This setup has been tested on the following Ubuntu LTS releases: +This setup has been tested on the following Linux releases: -- Ubuntu [16.04 LTS (Xenial Xerus)][xenial] -- Ubuntu [18.04 LTS (Bionic Beaver)][bionic] -- Ubuntu [20.04 LTS (Focal Fossa)][focal] +- [Ubuntu 20.04 LTS (Focal Fossa)][focal] +- [Debian 10 "buster"][buster] -The older Ubuntu versions are only tested using Travis CI builds. +Older releases are only tested using Travis CI builds and might not be fully +supported: + +- [Ubuntu 18.04 LTS (Bionic Beaver)][bionic] +- [Ubuntu 16.04 LTS (Xenial Xerus)][xenial] -[ubuntu]: https://www.ubuntu.com/ [xenial]: http://releases.ubuntu.com/16.04/ [bionic]: http://releases.ubuntu.com/18.04/ [focal]: http://releases.ubuntu.com/20.04/ +[buster]: https://www.debian.org/releases/buster/ ### Ubuntu on WSL @@ -68,7 +72,8 @@ will be skipped during the set up. ### Pengwin on WSL I'm no longer using or testing the playbooks on Pengwin Linux since I've -upgraded to WSL2 and Ubuntu 20.04 LTS on my Windows 10 environment. +upgraded to WSL2 and Ubuntu 20.04 LTS and Debian buster on my Windows 10 +environment. ## Install @@ -432,16 +437,16 @@ asdf_plugins: Use Ubuntu/Debian packages to install Python on the system: -- [Python] with `python` package — installed Python version will depend on the +- [Python] with `python3` package — installed Python version will depend on the OS release version -- [pip] with `python-pip` package +- [pip] with `python3-pip` package - [virtualenv] from PyPI Use [pyenv] to install and manage Python versions for the current user: - [pyenv] - [pyenv-virtualenv] -- [Python] v3.7 installed with pyenv +- [Python] 3.7 and 3.8 installed with pyenv Run Python playbook: diff --git a/setup b/setup index a4733a1..cdd5d39 100755 --- a/setup +++ b/setup @@ -3,6 +3,9 @@ # Setup script for https://github.com/markosamuli/linux-machine and # https://github.com/markosamuli/macos-machine Ansible playbooks. # +# 2020-09-07: +# - Support for Debian +# # 2020-09-06: # - Upgrade outdated Ansible Homebrew formula # - Detect installed Ansible Homebrew path correctly during install