Merge pull request #36 from samvera-labs/orb-tools

Updates the orb testing/publishing workflow

.circleci/config.yml

@@ -1,29 +1,66 @@
 version: 2.1
 
 orbs:
-  orb-tools: circleci/orb-tools@8.1.0
-  samvera: samvera/circleci-orb@dev:alpha
+    orb-tools: circleci/orb-tools@10.0.3
+    samvera: samvera/circleci-orb@dev:alpha
 
-executors:
-  ci-base:
-    resource_class: small
-    docker:
-      - image: cibuilds/base
+orb_promotion_filters: &orb_promotion_filters
+    branches:
+        ignore: /.*/
+    tags:
+        only: /^(major|minor|patch)-release-v\d+\.\d+\.\d+$/
+
+parameters:
+    run-integration-tests:
+        type: boolean
+        default: false
+    dev-orb-version:
+        type: string
+        default: 'dev:alpha'
 
 jobs:
-# yaml anchor filters
-workflows:
-  lint_pack-validate_publish-dev:
-    jobs:
-      - orb-tools/lint
+    integration-tests:
+        docker:
+            - image: cimg/base:stable
+        steps:
+            - checkout
+            # TODO: integration testing
 
-      - orb-tools/pack:
-          requires:
+workflows:
+    lint_pack-validate_publish-dev:
+        unless: << pipeline.parameters.run-integration-tests >>
+        jobs:
             - orb-tools/lint
-      # Disabled until we have an API token - maybe forever?
-      #
-      # - orb-tools/publish-dev:
-      #     context: orb-publishing
-      #     orb-name: samvera/circleci-orb
-      #     requires:
-      #       - orb-tools/pack
+
+            - orb-tools/pack
+
+            - orb-tools/publish-dev:
+                orb-name: samvera/circleci-orb
+                requires:
+                    - orb-tools/lint
+                    - orb-tools/pack
+
+            - orb-tools/trigger-integration-tests-workflow:
+                name: trigger-integration-dev
+                requires:
+                    - orb-tools/publish-dev
+
+    integration-tests:
+        when: << pipeline.parameters.run-integration-tests >>
+        jobs:
+            - integration-tests
+
+    tag-triggered-orb-publishing:
+        unless: << pipeline.parameters.run-integration-tests >>
+        jobs:
+            # To approve the job, visit the Workflows page in CircleCI
+            - hold-for-approval:
+                type: approval
+                filters: *orb_promotion_filters
+
+            - orb-tools/dev-promote-prod-from-git-tag:
+                orb-name: samvera/circleci-orb
+                add-pr-comment: false
+                requires:
+                    - hold-for-approval
+                filters: *orb_promotion_filters

README.md

@@ -49,6 +49,14 @@ Be prepared! Control your destiny! Specify versions!
 
 ## Releasing new versions
 
+The orb will automatically publish two dev versions with every build that passes checks.
+The first is always `dev:alpha`. Since this is not a unique identifier, this version may be quickly
+overwritten. The other is `dev:<SHA1>`, where the SHA1 is the first seven characters of the commit hash
+that was built.
+Orb versions that begin with `dev:` can be overwritten by anyone, and only exist for 90 days.
+
+Additionally, publishing dev and production versions of the orb can be done manually:
+
 1. Install the CircleCI Client -
    [https://circleci.com/docs/2.0/local-cli/#installation](https://circleci.com/docs/2.0/local-cli/#installation)
 2. `circleci setup` (You'll need an API key)