Merge branch 'develop' into runner-name

Author: MonolithProjects

.github/workflows/galaxy.yml

@@ -8,7 +8,7 @@ on:
 
 jobs:
   release:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-18.04
     steps:
       - name: galaxy
         uses: robertdebock/[email protected]

.github/workflows/lifecycle.yml

@@ -0,0 +1,21 @@
+name: molecule lint
+
+on:
+    push:
+        branches:
+            - develop
+            - feature/*
+jobs:
+  lint:
+    runs-on: ubuntu-18.04
+    strategy:
+      fail-fast: true
+    steps:
+      - name: checkout
+        uses: actions/checkout@v2
+        with:
+          path: "${{ github.repository }}"
+      - name: Molecule for Ansible - lint
+        uses: MonolithProjects/[email protected]
+        with:
+          molecule_command: lint

.github/workflows/lint.yml

@@ -4,19 +4,30 @@ on:
     push:
         branches:
             - master
+    pull_request:
+        types: [opened, synchronize, reopened]
     schedule:
         - cron: '0 6 * * 0'
 jobs:
   test:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-18.04
     strategy:
-      fail-fast: false
+      fail-fast: true
     steps:
       - name: checkout
         uses: actions/checkout@v2
         with:
           path: "${{ github.repository }}"
-      - name: Molecule for Ansible
-        uses: MonolithProjects/action-molecule@v1.3.0
+      - name: Molecule for Ansible - GHR Repository
+        uses: MonolithProjects/action-molecule@v1.4.0
         env:
-          PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+          PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+        with:
+          molecule_command: test
+      - name: Molecule for Ansible - GHR Organization
+        uses: MonolithProjects/[email protected]
+        env:
+          PERSONAL_ACCESS_TOKEN: ${{ secrets.PERSONAL_ACCESS_TOKEN }}
+        with:
+          molecule_command: test
+          scenario: organization

.github/workflows/main.yml

@@ -6,7 +6,8 @@
 [![GitHub Actions](https://github.com/MonolithProjects/ansible-github_actions_runner/workflows/molecule%20test/badge.svg?branch=master)](https://github.com/MonolithProjects/ansible-github_actions_runner/actions)
 [![License](https://img.shields.io/github/license/MonolithProjects/ansible-github_actions_runner)](https://github.com/MonolithProjects/ansible-github_actions_runner/blob/master/LICENSE)
 
-This role will deploy/redeploy/uninstall and register/unregister local GitHub Actions Runner.
+This role will deploy/redeploy/uninstall and register/unregister local GitHub Actions Runner.  
+It supports both, Organization and Repository Runners.
 
 ## Requirements
 
@@ -26,10 +27,10 @@ Personal Access Token for GitHub account can be created [here](https://github.co
 * Weekly tested on:
   * CentOS/RHEL 7,8
   * Debian 9,10
-  * Fedora 31,32
+  * Fedora 32,33
   * Ubuntu 16,18,20
 
-  **Note:** Fedora 32 and Ubuntu 20 must use Ansible 2.9.8+. Other distros/releases will work also with older 2.8.0+ Ansible.
+  **Note:** Fedora 32+ and Ubuntu 20 must use Ansible 2.9.8+. Other distros/releases will work also with older 2.8.0+ Ansible.
 
 ## Role Variables
 
@@ -45,22 +46,22 @@ runner_dir: /opt/actions-runner
 # Version of the GitHub Actions Runner
 runner_version: "latest"
 
-# If found, replace already registered runner
-replace_runner: yes
+# State in which the runner service will be after the role is done (started, stopped, absent)
+runner_state: "started"
 
-# If found, delete already existed runner before install
-uninstall_runner: no
+# If found on the server, delete already existed runner service before install
+reinstall_runner: no
 
-# Do not show Ansible logs which may contain sensitive data (registration token)
+# Do not show Ansible error logs which may contain sensitive data (registration token)
 hide_sensitive_logs: yes
 
 # GitHub address
 github_server: "https://github.com"
 
-# Personal Access Token
+# Personal Access Token for your GitHub account
 access_token: "{{ lookup('env', 'PERSONAL_ACCESS_TOKEN') }}"
 
-# Is it runner for organization or not
+# Is it the runner for organization or not
 runner_org: no
 
 # Name to assign to this runner in GitHub
@@ -78,12 +79,12 @@ runner_name: "{{ lookup('pipe', 'hostname') }}"
 
 ## Example Playbook
 
-In this example the Ansible role will deploy (or redeploy) the GitHub Actions runner service (latest available version) and register the runner for the GitHub repo.
-Runner service will run under the same user as the Ansible is using for ssh connection (*ansible*).
+In this example the Ansible role will install (or update) the GitHub Actions Runner service (latest available version). The runner will be registered for *my_awesome_repo* GitHub repo.
+Runner service will be stated and will run under the same user as the Ansible is using for ssh connection (*ansible*).
 
 ```yaml
 ---
-- name: GitHub Actions Runner
+- name: Install GitHub Actions Runner
   hosts: all
   user: ansible
   become: yes
@@ -94,11 +95,11 @@ Runner service will run under the same user as the Ansible is using for ssh conn
     - role: monolithprojects.github_actions_runner
 ```
 
-Same example, but runner will be added to an organization
+Same example as above, but runner will be added to an organization.
 
 ```yaml
 ---
-- name: GitHub Actions Runner
+- name: Install GitHub Actions Runner
   hosts: all
   user: ansible
   become: yes
@@ -109,26 +110,37 @@ Same example, but runner will be added to an organization
     - role: monolithprojects.github_actions_runner
 ```
 
-In this example the Ansible role will deploy (or redeploy) the GitHub Actions runner service (version 2.165.2) and register the runner for the GitHub repo. Runner service will run under the user `runner-user`.
+In this example the Ansible role will deploy (or update) the GitHub Actions runner service (version 2.165.2) and register the runner for the GitHub repo. Runner service will run under the user `runner-user`.
+The runner service will be *stopped*.
 
 ```yaml
 ---
-- name: GitHub Actions Runner
+- name: Stop GitHub Actions Runner
   hosts: all
   become: yes
   vars:
     - runner_version: "2.165.2"
     - runner_user: runner-user
     - github_account: github-access-user
     - github_repo: my_awesome_repo
+    - runner_state: "stopped"
   roles:
     - role: monolithprojects.github_actions_runner
 ```
 
-By using tag `uninstall` with combination of variable `uninstall_runner: yes`, GitHub Actions runner will be removed from the host and unregistered from the GitHub repository.
+In this example the Ansible role will uninstall the runner service and unregister it from the GitHub Repository.
 
-```bash
-ansible-playbook playbook.yml --tags uninstall -e "uninstall_runner=yes"
+```yaml
+---
+- name: Uninstall GitHub Actions Runner
+  hosts: all
+  become: yes
+  vars:
+    - github_account: github-access-user
+    - github_repo: my_awesome_repo
+    - runner_state: "absent"
+  roles:
+    - role: monolithprojects.github_actions_runner
 ```
 
 ## License

README.md

@@ -8,11 +8,11 @@ runner_dir: /opt/actions-runner
 # Version of the GitHub Actions Runner
 runner_version: "latest"
 
-# If found, replace already registered runner
-replace_runner: yes
+# State in which the runner service will be after the role is done (started, stopped, absent)
+runner_state: "started"
 
-# If found, delete already existed runner before install
-uninstall_runner: no
+# If found on the server, delete already existed runner service before install
+reinstall_runner: no
 
 # Do not show Ansible logs which may contain sensitive data (registration token)
 hide_sensitive_logs: yes
@@ -23,7 +23,7 @@ github_server: "https://github.com"
 # Personal Access Token for your GitHub account
 access_token: "{{ lookup('env', 'PERSONAL_ACCESS_TOKEN') }}"
 
-# Is it runner for organization or not
+# Is it the runner for organization or not
 runner_org: no
 
 # Name to assign to this runner in GitHub

defaults/main.yml

@@ -0,0 +1,12 @@
+---
+- name: Cleanup
+  user: ansible
+  hosts: all
+  become: yes
+  vars:
+    - runner_user: ansible
+    - github_repo: ansible-github_actions_runner-testrepo
+    - github_account: monolithprojects
+    - runner_state: absent
+  roles:
+    - ansible-github_actions_runner

molecule/default/cleanup.yml

@@ -1,12 +1,27 @@
 ---
-- name: Converge
+- name: Install
   user: ansible
   hosts: all
   become: yes
   vars:
     - runner_user: ansible
     - github_repo: ansible-github_actions_runner-testrepo
     - github_account: monolithprojects
+    - runner_version: "latest"
+  roles:
+    - robertdebock.epel
+    - ansible-github_actions_runner
+
+- name: Reinstall
+  user: ansible
+  hosts: all
+  become: yes
+  vars:
+    - runner_user: ansible
+    - github_repo: ansible-github_actions_runner-testrepo
+    - github_account: monolithprojects
+    - reinstall_runner: yes
+    - runner_version: "latest"
   roles:
     - robertdebock.epel
     - ansible-github_actions_runner

molecule/default/converge.yml

@@ -2,7 +2,6 @@
 driver:
   name: docker
 lint: |
-  set -e
   yamllint .
   ansible-lint
 platforms:
@@ -36,6 +35,16 @@ platforms:
       - /sys/fs/cgroup:/sys/fs/cgroup:ro
     privileged: yes
     pre_build_image: yes
+  - name: Fedora33
+    image: monolithprojects/systemd-fedora33:latest
+    command: /sbin/init
+    tmpfs:
+      - /run
+      - /tmp
+    volumes:
+      - /sys/fs/cgroup:/sys/fs/cgroup:ro
+    privileged: yes
+    pre_build_image: yes
   - name: Ubuntu16
     image: monolithprojects/systemd-ubuntu16:latest
     command: /sbin/init
@@ -105,7 +114,8 @@ provisioner:
       Ubuntu20:
         ansible_python_interpreter: /usr/bin/python3
 verifier:
-  name: ansible
+  name: testinfra
+  directory: tests
 dependency:
   name: galaxy
   options:
@@ -116,11 +126,10 @@ scenario:
   test_sequence:
     - dependency
     - lint
-    - cleanup
     - destroy
     - syntax
     - create
-    - prepare
+    # - prepare
     - converge
     # - idempotence
     - cleanup