<!-- To get the ID, use: ansible-galaxy info tehtbl.ssh_server | grep -i "id:" -->
<a href="https://galaxy.ansible.com/tehtbl/ssh_server"><img src="https://img.shields.io/ansible/role/45336"/></a> 
<a href="https://galaxy.ansible.com/tehtbl/ssh_server"><img src="https://img.shields.io/ansible/quality/45336"/></a> 
<a href="https://travis-ci.org/tehtbl/ansible-role-ssh_server"><img src="https://travis-ci.org/tehtbl/ansible-role-ssh_server.svg?branch=master" alt="Build status"/></a>

Role Description
================

This role installs and sets up an OpenSSH server on your system.

Example Playbook
================

Here is a simple playbook example, taken from `molecule/default/converge.yml`. It is tested every time changes are made or released.

```yaml
---
- name: Converge
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: tehtbl.ssh_server

Make sure your machine is ready to run this role. The following playbook helps prepare your system.

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: tehtbl.bootstrap

Role Variables

The following variables can be found in defaults/main.yml:

---
# ------------------------------------------------------------------------
# Defaults for ssh_server role
# ------------------------------------------------------------------------

# Take new SSH server keys
ssh_server_renew_keys: false

# Copy issue.net file
ssh_server_copy_issue_net: true

# Specify users allowed to connect
ssh_server_allow_users:
  - "*"

Requirements

• You should have access to a repository with the necessary packages, usually found online.
• A current version of Ansible is needed. (Tests are run on the current, previous, and upcoming versions of Ansible.)

Context

This role works well with many other roles. Check out my other roles for more information.

Compatibility

This role has been tested on these Docker images:

Container	Tag	Allow Failures
debian	stable	no
debian	testing	no
debian	unstable	yes
ubuntu	xenial	yes
ubuntu	bionic	no
ubuntu	focal	no
ubuntu	devel	yes

The role has also been tested on these Ansible versions:

• ansible >= 2.8, < 2.9
• ansible >= 2.9
• git+https://github.com/ansible/ansible.git@devel

Testing Using Tox

Unit tests are performed on every commit, pull request, and release.

If you find any issues, please report them on GitHub.

Testing uses Tox and Molecule:

Tox tests various Ansible versions, while Molecule tests different distributions.

To run tests with default settings (any installed Ansible version, namespace: tehtbl, image: ubuntu, tag: latest):

molecule test

# Or specify a specific image:
IMAGE="ubuntu" molecule test

# Or set both a specific image and a specific tag:
IMAGE="debian" TAG="stable" tox

You can also test multiple versions of Ansible with the right images:

Tox can check multiple Ansible versions at once. To run tests with default settings:

tox

# Run Ubuntu tests:
IMAGE="ubuntu" tox

# Or customize further:
IMAGE="debian" TAG="stable" tox -e py37-ansible-current

Testing Using Vagrant

Install vagrant plugins by running:

vagrant plugin install vagrant-reload

Start tests using the VirtualBox provider:

vagrant up

License

MIT License

Author Information

Sources

This work is inspired by many great individuals, including Robert de Bock, Jeff Geerling, and Thomas Waldmann. Thank you! ```