docs: release v3.0.0

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

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:
 

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