Merge "Pin Ansible Galaxy dependencies"

doc/source/development/development.rst

@@ -0,0 +1,22 @@
+===========
+Development
+===========
+
+Ansible Galaxy
+==============
+
+Kayobe uses a number of Ansible roles hosted on Ansible Galaxy. The role
+dependencies are tracked in ``requirements.yml``, and specify required
+versions. The process for changing a Galaxy role is as follows:
+
+#. If required, develop changes for the role. This may be done outside of
+   Kayobe, or by modifying the role in place during development. If upstream
+   changes to the role have already been made, this step can be skipped.
+#. Commit changes to the role, typically via a Github pull request.
+#. Request that a tagged release of the role be made, or make one if you have
+   the necessary privileges.
+#. Ensure that automatic imports are configured for the role using e.g. a
+   TravisCI webhook notification, or perform a manual import of the role on
+   Ansible Galaxy.
+#. Modify the version in ``requirements.yml`` to match the new release of the
+   role.

doc/source/development/index.rst

@@ -8,5 +8,6 @@ Kayobe Development Guide
    vagrant
    manual
    automated
+   development
    testing
    contributing

requirements.yml

@@ -1,25 +1,44 @@
 ---
 - src: ahuffman.resolv
+  version: v1.2
 - src: jriguera.configdrive
+  # There are no versioned releases of this role.
+  version: 6b5f1d55bc3f27fa2855d8dd59b5c224d160d806
 - src: MichaelRigart.interfaces
+  version: v1.1.0
 - src: mrlesmithjr.manage-lvm
+  version: v0.1.1
 - src: resmo.ntp
-#- src: singleplatform-eng.users
-- src: https://github.com/stackhpc/ansible-users
-  version: append
-  name: singleplatform-eng.users
+  version: 0.4.0
+- src: singleplatform-eng.users
+  version: v1.2.5
 - src: stackhpc.dell-powerconnect-switch
+  version: v1.0.0
 - src: stackhpc.drac
+  version: 1.1.4
 - src: stackhpc.drac-facts
+  version: 1.0.0
 - src: stackhpc.grafana-conf
+  version: 1.0
 - src: stackhpc.libvirt-host
+  version: v1.1.0
 - src: stackhpc.libvirt-vm
+  version: v1.1.0
 - src: stackhpc.mellanox-switch
+  version: v1.0.0
 - src: stackhpc.os-flavors
+  version: v1.0.0
 - src: stackhpc.os-images
+  version: v1.0.0
 - src: stackhpc.os-ironic-state
+  version: v1.0.0
 - src: stackhpc.os-networks
+  version: v1.0.0
 - src: stackhpc.os-openstackclient
+  version: v1.2.0
 - src: stackhpc.os-projects
+  version: v1.1.2
 - src: stackhpc.os-shade
+  version: v1.2.0
 - src: yatesr.timezone
+  version: 1.1.0