https://github.com/streamdal/schema-publisher-orb

CircleCI Orb for publishing updated artifacts to a Batch.sh schema
https://github.com/streamdal/schema-publisher-orb

Last synced: about 1 year ago
JSON representation

CircleCI Orb for publishing updated artifacts to a Batch.sh schema

• Host: GitHub
• URL: https://github.com/streamdal/schema-publisher-orb
• Owner: streamdal
• License: mit
• Created: 2022-08-16T18:10:35.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-08-17T22:19:04.000Z (over 3 years ago)
• Last Synced: 2025-01-14T03:10:54.002Z (over 1 year ago)
• Language: Go
• Size: 7.17 MB
• Stars: 0
• Watchers: 6
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# schema-publisher-orb

[![CircleCI Build Status](https://circleci.com/gh/batchcorp/schema-publisher-orb.svg?style=shield "CircleCI Build Status")](https://circleci.com/gh/batchcorp/schema-publisher-orb) [![CircleCI Orb Version](https://badges.circleci.com/orbs/batchcorp/schema-publisher-orb.svg)](https://circleci.com/orbs/registry/orb/batchcorp/schema-publisher-orb) [![GitHub License](https://img.shields.io/badge/license-MIT-lightgrey.svg)](https://raw.githubusercontent.com/batchcorp/schema-publisher-orb/master/LICENSE) [![CircleCI Community](https://img.shields.io/badge/community-CircleCI%20Discuss-343434.svg)](https://discuss.circleci.com/c/ecosystem/orbs)

Orb to publish updated protobuf artifacts to an existing Batch.sh schema

---

## Documentation

* https://docs.batch.sh/platform/components/what-are-schemas/circleci-orb

* https://circleci.com/developer/orbs/orb/batchcorp/schema-publisher-orb

## Required environment variables

The following environment variables are required to be set in your CircleCI project before you can use this orb:

`BATCH_API_TOKEN` - Obtain an API key from https://console.batch.sh/account/security

## Resources

[CircleCI Orb Registry Page](https://circleci.com/orbs/registry/orb/batchcorp/schema-publisher-orb) - The official registry page of this orb for all versions, executors, commands, and jobs described.

[CircleCI Orb Docs](https://circleci.com/docs/2.0/orb-intro/#section=configuration) - Docs for using, creating, and publishing CircleCI Orbs.

### How to Contribute

We welcome [issues](https://github.com/batchcorp/schema-publisher-orb/issues) to and [pull requests](https://github.com/batchcorp/schema-publisher-orb/pulls) against this repository!

### How to Publish An Update

1. Merge pull requests with desired changes to the main branch.

    - For the best experience, squash-and-merge and use [Conventional Commit Messages](https://conventionalcommits.org/).

2. Find the current version of the orb.

    - You can run `circleci orb info batchcorp/schema-publisher-orb | grep "Latest"` to see the current version.

3. Create a [new Release](https://github.com/batchcorp/schema-publisher-orb/releases/new) on GitHub.

    - Click "Choose a tag" and _create_ a new [semantically versioned](http://semver.org/) tag. (ex: v1.0.0)

      - We will have an opportunity to change this before we publish if needed after the next step.

4.  Click _"+ Auto-generate release notes"_.

    - This will create a summary of all of the merged pull requests since the previous release.

    - If you have used _[Conventional Commit Messages](https://conventionalcommits.org/)_ it will be easy to determine what types of changes were made, allowing you to ensure the correct version tag is being published.

5. Now ensure the version tag selected is semantically accurate based on the changes included.

6. Click _"Publish Release"_.

    - This will push a new tag and trigger your publishing pipeline on CircleCI.