Skip to content

Latest commit

 

History

History
64 lines (47 loc) · 2.56 KB

README.md

File metadata and controls

64 lines (47 loc) · 2.56 KB

drone-gdm

Build Status License Docker Pulls

A simple drone plugin which wraps Google Deployment Manager, licensed under the Apache 2.0 License.

Features

  • Set the desired state (absent, present, or latest) and the plugin determines whether to create, update, or delete.
  • Support for all GDM v1 types, composites, type-providers, and beta/alpha features

ℹ️ See the usage and examples for additional detail.

Example Usage

deploy:
  gdm:
    image: nytimes/drone-gdm:v2-stable
    # Provided JSON auth token (from drone secrets):
    token: >
      $$GOOGLE_JSON_CREDENTIALS
    project: my-gcp-project
    configurations:
    - name: my-deployment
      group: deployment
      state: latest
      description: A basic GDM deployment yaml file which creates some resources
      path: ./my-deployment.yaml

Versions/Compatibility

Drone-GDM uses a subset of semantic versioning (see this doc for specifics). A list of releases can be found here.

The latest stable, major-tracking, release is v2-stable (tested with drone 0.5 - 1).

Docker Tags

Docker release images carry the same M.m.p version as the github release tag which built them.

Major-only tracking tags are also provided which allow you to pin to the latest version of a major release (or pre-release) without risking breaking changes, e.g.:

  • v2-alpha: latest 2.x alpha release
  • v2-beta: latest 2.x beta release
  • v2-stable: latest 2.x stable release

The latest merge to main which builds successfully in the CI pipeline is always tagged as latest.

Resources