Adds go jobs and roles.

Adds jobs to test and build go packages.
Adds a role to download and install go from
the official download page (https://golang.org/dl/).
Adds a role to run commands with go e.g build, test, run.

Change-Id: Iad2d877fffa2530e9fdeec648a60755a80cf01f4

doc/source/go-jobs.rst

@@ -0,0 +1,5 @@
+Go Jobs
+=======
+
+.. zuul:autojob:: golang-go
+.. zuul:autojob:: golang-go-test

doc/source/go-roles.rst

@@ -0,0 +1,5 @@
+Go Roles
+========
+
+.. zuul:autorole:: install-go
+.. zuul:autorole:: go

doc/source/jobs.rst

@@ -8,3 +8,4 @@ Jobs
    python-jobs
    js-jobs
    docker-jobs
+   go-jobs

doc/source/roles.rst

@@ -11,6 +11,7 @@ Roles
    cloud-roles
    deprecated-roles
    galaxy-roles
+   go-roles
    js-roles
    launchpad-roles
    puppet-roles

playbooks/go/pre.yaml

@@ -0,0 +1,3 @@
+- hosts: all
+  roles:
+    - install-go

playbooks/go/run.yaml

@@ -0,0 +1,4 @@
+- hosts: all
+  roles:
+    - revoke-sudo
+    - go

roles/go/README.rst

@@ -0,0 +1,24 @@
+Run go command in a source directory. Assumes the appropriate version
+of go has been installed.
+
+**Role Variables**
+
+.. zuul:rolevar:: go_command
+
+   Go command to run.
+   This parameter is mandatory.
+   Examples are "test", "run" or "build"
+
+.. zuul:rolevar:: go_package_dir
+
+   Directory of the affected go package.
+
+.. zuul:rolevar:: go_bin_path
+   :default: {{ go_install_dir }}/go/bin
+
+   Path to go bin directory
+
+.. zuul:rolevar:: zuul_work_dir
+   :default: {{ zuul.project.src_dir }}
+
+   Directory to run go in.

roles/go/defaults/main.yaml

@@ -0,0 +1,3 @@
+zuul_work_dir: "{{ zuul.project.src_dir }}"
+go_install_dir: "/usr/local"
+go_bin_path: "{{ go_install_dir }}/go/bin"

roles/go/tasks/main.yaml

@@ -0,0 +1,13 @@
+- name: Require go_command variable
+  fail:
+    msg: go_command is required for this role
+  when: go_command is not defined
+
+- name: Run go command
+  command: >-
+    go {{ go_command }}
+    {% if go_package_dir is defined %}'./{{ go_package_dir }}'{% endif %}
+  args:
+    chdir: "{{ zuul_work_dir }}"
+  environment:
+    PATH: "{{ ansible_env.PATH }}:{{ go_bin_path }}"

roles/install-go/README.rst

@@ -0,0 +1,17 @@
+Install go
+
+**Role Variables**
+
+.. zuul:rolevar:: go_install_dir
+   :default: /usr/local/
+
+   Directory to install go in.
+
+.. zuul:rolevar:: go_version
+   :default: 1.13
+
+.. zuul:rolevar:: go_os
+   :default: {{ ansible_system | lower }}
+
+.. zuul:rolevar:: go_arch
+   :default: amd64 / 386

roles/install-go/defaults/main.yaml

@@ -0,0 +1,4 @@
+go_version: "1.13"
+go_os: "{{ ansible_system | lower }}"
+go_arch: "{{ go_arch_translation[ansible_architecture] }}"
+go_install_dir: "/usr/local"

roles/install-go/tasks/main.yaml

@@ -0,0 +1,39 @@
+- name: Check installed go version
+  command: go version
+  register: go_installed_version
+  environment:
+    PATH: "{{ ansible_env.PATH }}:{{ go_install_dir }}/go/bin"
+  ignore_errors: yes
+
+- name: Skip if correct version of go is installed
+  meta: end_host
+  when:
+    - go_installed_version.rc == 0
+    - go_version == (go_installed_version.stdout|regex_replace(go_version_pattern, '\\g<version>'))
+    - go_os == (go_installed_version.stdout|regex_replace(go_version_pattern, '\\g<os>'))
+    - go_arch == (go_installed_version.stdout|regex_replace(go_version_pattern, '\\g<arch>'))
+
+- name: Create temp directory
+  tempfile:
+    state: directory
+  register: go_archive_tempdir
+
+- name: Get archive checksum
+  uri:
+    url: "https://dl.google.com/go/go{{ go_version }}.{{ go_os }}-{{ go_arch }}.tar.gz.sha256"
+    return_content: true
+  register: go_archive_checksum
+
+
+- name: Download go archive
+  get_url:
+    url: "https://dl.google.com/go/go{{ go_version }}.{{ go_os }}-{{ go_arch }}.tar.gz"
+    dest: "{{ go_archive_tempdir.path }}/go{{ go_version }}.{{ go_os }}-{{ go_arch }}.tar.gz"
+    checksum: "sha256:{{ go_archive_checksum.content }}"
+
+- name: Install go
+  unarchive:
+    src: "{{ go_archive_tempdir.path }}/go{{ go_version }}.{{ go_os }}-{{ go_arch }}.tar.gz"
+    dest: "{{ go_install_dir }}"
+    remote_src: yes
+  become: true

roles/install-go/vars/main.yaml

@@ -0,0 +1,6 @@
+go_arch_translation:
+  amd64: amd64
+  x86_64: amd64
+  i386: 386
+
+go_version_pattern: ^go version go(?P<version>.*?) (?P<os>.*?)/(?P<arch>.*?)$

zuul-tests.d/go-roles-jobs.yaml

@@ -0,0 +1,18 @@
+- job:
+    name: zuul-jobs-test-golang-go
+    parent: golang-go
+    description: Test the golang-go job
+    files:
+      - playbooks/go
+      - roles/install-go
+      - role/go
+      - zuul.d/go-jobs.yaml
+    vars:
+      go_command: version
+
+- project:
+    check:
+      jobs: &id001
+        - zuul-jobs-test-golang-go
+    gate:
+      jobs: *id001

zuul.d/go-jobs.yaml

@@ -0,0 +1,92 @@
+# Jobs listed in go-jobs.rst.
+
+- job:
+    name: golang-go
+    parent: unittests
+    description: |
+      Base job for go operations
+
+      Responds to these variables:
+
+      .. zuul:jobvar:: go_command
+         :default: build
+
+         Command to pass to go.
+
+      .. zuul:jobvar:: go_package_dir
+
+         Path to go package to test
+
+      .. zuul:jobvar:: go_install_dir
+         :default: /usr/local/
+
+         Path to install go in
+
+      .. zuul:jobvar:: go_version
+         :default: 1.13
+
+         The version of go to use.
+
+      .. zuul:jobvar:: go_os
+         :default: {{ ansible_system | lower }}
+
+          OS to use when choosing go version.
+
+      .. zuul:jobvar:: go_arch
+         :default: amd64 / 386
+
+          Architecture to use when choosing go version
+
+      .. zuul:jobvar:: zuul_work_dir
+         :default: {{ zuul.project.src_dir }}
+
+         Path to operate in.
+
+    pre-run: playbooks/go/pre.yaml
+    run: playbooks/go/run.yaml
+    vars:
+      go_command: build
+
+- job:
+    name: golang-go-test
+    parent: golang-go
+    description: |
+      Base job for go operations
+
+      Responds to these variables:
+
+      .. zuul:jobvar:: go_command
+         :default: build
+
+         Command to pass to go.
+
+      .. zuul:jobvar:: go_package_dir
+
+         Path to go package to test
+
+      .. zuul:jobvar:: go_install_dir
+         :default: /usr/local/
+
+         Path to install go in
+
+      .. zuul:jobvar:: go_version
+         :default: 1.13
+
+         The version of go to use.
+
+      .. zuul:jobvar:: go_os
+         :default: {{ ansible_system | lower }}
+
+         OS to use when choosing go version.
+
+      .. zuul:jobvar:: go_arch
+         :default: amd64 / 386
+
+         Architecture to use when choosing go version
+
+      .. zuul:jobvar:: zuul_work_dir
+         :default: {{ zuul.project.src_dir }}
+
+         Path to operate in.
+    vars:
+      go_command: test