refactor docs

.drone.jsonnet

@@ -1,141 +1,155 @@
 local PipelineLinting = {
-    kind: "pipeline",
+  kind: 'pipeline',
-    name: "linting",
+  name: 'linting',
-    platform: {
+  platform: {
-        os: "linux",
+    os: 'linux',
-        arch: "amd64",
+    arch: 'amd64',
-    },
+  },
-    steps: [
+  steps: [
-        {
+    {
-            name: "ansible-later",
+      name: 'ansible-later',
-            image: "xoxys/ansible-later:latest",
+      image: 'xoxys/ansible-later:latest',
-            commands: [
+      commands: [
-                "ansible-later",
+        'ansible-later',
-            ],
+      ],
-        },
-    ],
-    trigger: {
-        ref: ["refs/heads/master", "refs/tags/**", "refs/pull/**"],
     },
+  ],
+  trigger: {
+    ref: ['refs/heads/master', 'refs/tags/**', 'refs/pull/**'],
+  },
 };
 
-local PipelineDeployment = {
+local PipelineDeployment(scenario='centos7') = {
-    kind: "pipeline",
+  kind: 'pipeline',
-    name: "deployment",
+  name: 'testing-' + scenario,
-    platform: {
+  platform: {
-        os: "linux",
+    os: 'linux',
-        arch: "amd64",
+    arch: 'amd64',
-    },
+  },
-    concurrency: {
+  concurrency: {
-        limit: 1
+    limit: 1,
-    },
+  },
-    workspace: {
+  workspace: {
-        base: "/drone/src",
+    base: '/drone/src',
-        path: "xoxys.facts"
+    path: 'xoxys.facts',
-    },
+  },
-    steps: [
+  steps: [
-        {
+    {
-            name: "ansible-molecule",
+      name: 'ansible-molecule',
-            image: "xoxys/molecule:latest",
+      image: 'xoxys/molecule:latest',
-            environment: {
+      environment: {
-                DO_API_KEY: { "from_secret": "do_api_key" },
+        DO_API_KEY: { from_secret: 'do_api_key' },
-                USER: "root",
+        USER: 'root',
-                MOLECULE_CUSTOM_MODULES_REPO: "https://gitea.rknet.org/ansible/custom_modules",
+        MOLECULE_CUSTOM_MODULES_REPO: 'https://gitea.rknet.org/ansible/custom_modules',
-                MOLECULE_CUSTOM_FILTERS_REPO: "https://gitea.rknet.org/ansible/custom_filters",
+        MOLECULE_CUSTOM_FILTERS_REPO: 'https://gitea.rknet.org/ansible/custom_filters',
-            },
+      },
-            commands: [
+      commands: [
-                "molecule test -s default",
+        'molecule test -s' + scenario,
-            ],
+      ],
-        },
-    ],
-    depends_on: [
-        "linting",
-    ],
-    trigger: {
-        ref: ["refs/heads/master", "refs/tags/**"],
     },
+  ],
+  depends_on: [
+    'linting',
+  ],
+  trigger: {
+    ref: ['refs/heads/master', 'refs/tags/**'],
+  },
 };
 
 local PipelineDocumentation = {
-    kind: "pipeline",
+  kind: 'pipeline',
-    name: "documentation",
+  name: 'documentation',
-    platform: {
+  platform: {
-        os: "linux",
+    os: 'linux',
-        arch: "amd64",
+    arch: 'amd64',
+  },
+  steps: [
+    {
+      name: 'generate',
+      image: 'xoxys/ansible-doctor:latest',
+      environment: {
+        ANSIBLE_DOCTOR_LOG_LEVEL: 'INFO',
+        ANSIBLE_DOCTOR_FORCE_OVERWRITE: true,
+        ANSIBLE_DOCTOR_EXCLUDE_FILES: 'molecule/',
+        ANSIBLE_DOCTOR_TEMPLATE: 'hugo-book',
+        ANSIBLE_DOCTOR_ROLE_NAME: '${DRONE_REPO_NAME#*.}',
+        ANSIBLE_DOCTOR_OUTPUT_DIR: '_docs/',
+      },
     },
-    steps: [
+    {
-        {
+      name: 'publish',
-            name: "ansible-doctor",
+      image: 'plugins/gh-pages:latest',
-            image: "xoxys/ansible-doctor:latest",
+      settings: {
-            environment: {
+        remote_url: 'https://gitea.rknet.org/ansible/xoxys.facts',
-                ANSIBLE_DOCTOR_LOG_LEVEL: "INFO",
+        netrc_machine: 'gitea.rknet.org',
-                ANSIBLE_DOCTOR_FORCE_OVERWRITE: true,
+        username: { from_secret: 'gitea_username' },
-                ANSIBLE_DOCTOR_EXCLUDE_FILES: "molecule/",
+        password: { from_secret: 'gitea_token' },
-                ANSIBLE_DOCTOR_CUSTOM_HEADER: "HEADER.md",
+        pages_directory: '_docs/',
-            },
+        target_branch: 'docs',
-        },
+      },
-        {
+      when: {
-            name: "push-to-repo",
+        ref: ['refs/heads/master'],
-            image: "plugins/git-action:latest",
+      },
-            settings: {
-                actions: ["commit", "push"],
-                author_email: "shipper@rknet.org",
-                author_name: "DroneShipper",
-                branch: "master",
-                message: "[SKIP CI] update readme",
-                remote: "https://gitea.rknet.org/ansible/xoxys.facts",
-                netrc_machine: "gitea.rknet.org",
-                netrc_username: {"from_secret": "gitea_username"},
-                netrc_password: {"from_secret": "gitea_token"},
-            },
-            when: {
-                ref: ["refs/heads/master"],
-            },
-        },
-    ],
-    depends_on: [
-        "deployment",
-    ],
-    trigger: {
-        ref: ["refs/heads/master", "refs/tags/**", "refs/pull/**"],
     },
+    {
+      name: 'trigger',
+      image: 'plugins/downstream',
+      settings: {
+        server: 'https://drone.rknet.org',
+        token: { from_secret: 'drone_token' },
+        fork: true,
+        repositories: [
+          'ansible/ansible-galaxy',
+        ],
+      },
+      when: {
+        ref: ['refs/heads/master'],
+      },
+    },
+  ],
+  trigger: {
+    ref: ['refs/heads/master', 'refs/tags/**', 'refs/pull/**'],
+  },
+  depends_on: [
+    'testing-centos7',
+  ],
 };
 
-local PipelineNotification= {
+local PipelineNotification = {
-    kind: "pipeline",
+  kind: 'pipeline',
-    name: "notification",
+  name: 'notification',
-    platform: {
+  platform: {
-        os: "linux",
+    os: 'linux',
-        arch: "amd64",
+    arch: 'amd64',
-    },
+  },
-    clone: {
+  clone: {
-        disable: true,
+    disable: true,
-    },
+  },
-    steps: [
+  steps: [
-        {
+    {
-            name: "matrix",
+      name: 'matrix',
-            image: "plugins/matrix",
+      image: 'plugins/matrix',
-            settings: {
+      settings: {
-                homeserver: { "from_secret": "matrix_homeserver" },
+        homeserver: { from_secret: 'matrix_homeserver' },
-                roomid: { "from_secret": "matrix_roomid" },
+        roomid: { from_secret: 'matrix_roomid' },
-                template: "Status: **{{ build.status }}**<br/> Build: [{{ repo.Owner }}/{{ repo.Name }}]({{ build.link }}) ({{ build.branch }}) by {{ build.author }}<br/> Message: {{ build.message }}",
+        template: 'Status: **{{ build.status }}**<br/> Build: [{{ repo.Owner }}/{{ repo.Name }}]({{ build.link }}) ({{ build.branch }}) by {{ build.author }}<br/> Message: {{ build.message }}',
-                username: { "from_secret": "matrix_username" },
+        username: { from_secret: 'matrix_username' },
-                password: { "from_secret": "matrix_password" },
+        password: { from_secret: 'matrix_password' },
-            },
+      },
-        },
-    ],
-    depends_on: [
-        "documentation",
-    ],
-    trigger: {
-        status: [ "success", "failure" ],
-        ref: ["refs/heads/master", "refs/tags/**"],
     },
+  ],
+  depends_on: [
+    'documentation',
+  ],
+  trigger: {
+    status: ['success', 'failure'],
+    ref: ['refs/heads/master', 'refs/tags/**'],
+  },
 };
 
 [
-    PipelineLinting,
+  PipelineLinting,
-    PipelineDeployment,
+  PipelineDeployment(scenario='centos7'),
-    PipelineDocumentation,
+  PipelineDocumentation,
-    PipelineNotification,
+  PipelineNotification,
 ]

.drone.yml

@@ -20,7 +20,7 @@ trigger:
 
 ---
 kind: pipeline
-name: deployment
+name: testing-centos7
 
 platform:
   os: linux
@@ -37,7 +37,7 @@ steps:
 - name: ansible-molecule
   image: xoxys/molecule:latest
   commands:
-  - molecule test -s default
+  - molecule test -scentos7
   environment:
     DO_API_KEY:
       from_secret: do_api_key
@@ -62,30 +62,40 @@ platform:
   arch: amd64
 
 steps:
-- name: ansible-doctor
+- name: generate
   image: xoxys/ansible-doctor:latest
   environment:
-    ANSIBLE_DOCTOR_CUSTOM_HEADER: HEADER.md
     ANSIBLE_DOCTOR_EXCLUDE_FILES: molecule/
     ANSIBLE_DOCTOR_FORCE_OVERWRITE: true
     ANSIBLE_DOCTOR_LOG_LEVEL: INFO
+    ANSIBLE_DOCTOR_OUTPUT_DIR: _docs/
+    ANSIBLE_DOCTOR_ROLE_NAME: ${DRONE_REPO_NAME#*.}
+    ANSIBLE_DOCTOR_TEMPLATE: hugo-book
 
-- name: push-to-repo
+- name: publish
-  image: plugins/git-action:latest
+  image: plugins/gh-pages:latest
   settings:
-    actions:
-    - commit
-    - push
-    author_email: shipper@rknet.org
-    author_name: DroneShipper
-    branch: master
-    message: "[SKIP CI] update readme"
     netrc_machine: gitea.rknet.org
-    netrc_password:
+    pages_directory: _docs/
+    password:
       from_secret: gitea_token
-    netrc_username:
+    remote_url: https://gitea.rknet.org/ansible/xoxys.facts
+    target_branch: docs
+    username:
       from_secret: gitea_username
-    remote: https://gitea.rknet.org/ansible/xoxys.facts
+  when:
+    ref:
+    - refs/heads/master
+
+- name: trigger
+  image: plugins/downstream
+  settings:
+    fork: true
+    repositories:
+    - ansible/ansible-galaxy
+    server: https://drone.rknet.org
+    token:
+      from_secret: drone_token
   when:
     ref:
     - refs/heads/master
@@ -97,7 +107,7 @@ trigger:
   - refs/pull/**
 
 depends_on:
-- deployment
+- testing-centos7
 
 ---
 kind: pipeline
@@ -137,6 +147,6 @@ depends_on:
 
 ---
 kind: signature
-hmac: 44bac1b86bd42e9fa9ee6131b7e48f6f8b5529e5dbf97111e9465b451f5c7e7a
+hmac: efe1978288b472d437bca8f06fea21f29966641d077992ad09e00bcfb02c3c3b
 
 ...

HEADER.md

@@ -1,4 +0,0 @@
-# xoxys.facts
-  
-[![Build Status](https://drone.rknet.org/api/badges/ansible/xoxys.facts/status.svg)](https://drone.rknet.org/ansible/xoxys.facts)
-