README.md

• Managing OpenSearch Components
  • Install GH
  • Install Meta
  • Check Out Components
  • Get Repo Info
  • Add a New Component
  • Create or Update Release Labels
  • Create a Release Issue
  • Check for Release Tags
  • Check for Versions and Releases

Managing OpenSearch Components

We use meta to manage OpenSearch and OpenSearch Dashboards components as a set.

Install GH

Install and configure GitHub CLI from cli.github.com/manual/installation. Authenticate with gh auth login and ensure that it works, e.g. gh issue list.

Install Meta

npm install -g meta

Check Out Components

meta git update

Use meta git pull to subsequently pull the latest revisions.

Get Repo Info

meta gh issue list

Add a New Component

meta project import new-component git@github.com:opensearch-project/new-component.git

Create or Update Release Labels

Install ghi, e.g. brew install ghi.

meta exec "ghi label 'v1.2.0' -c '#b94c47'"

Create a Release Issue

We create release issues in all component repos that link back to a parent release issue in this repository.

1. Locate the parent issue, e.g. opensearch-build#567 for version 1.2.
2. Clone the last template in templates/releases/, and update version numbers and links, e.g. release-1.2.0.md.
3. From components, run meta exec "gh issue create --label v1.2.0 --title 'Release version 1.2' --body-file ../../templates/releases/release-1.2.0.md".

Check for Release Tags

Check whether a tag for version 1.1.0 exists.

meta exec "git ls-remote | grep -E 'refs/tags/1.1.0$'"

The command will fail and show in red for every repository without a tag.

Check for Versions and Releases

Check whether a version or a release exists.

meta exec "gh release list | grep -E '(1.1.0.*)$'"