Skip to content

Commit

Permalink
chore(build): updating default/build branch from master to develop (#89)
Browse files Browse the repository at this point in the history
* updating branch reference from master to develop in following files:
- CONTRIBUTING.md
- GOVERNANCE.md
- README.md
- RELEASE.md
- buildscripts/install-test-dep.sh
- code-standard.md
- developer-setup.md

* chore(workflow): push images to ghcr

Signed-off-by: mayank <[email protected]>
  • Loading branch information
mynktl authored and kmova committed Sep 13, 2021
1 parent 72b38d8 commit 6f449fc
Show file tree
Hide file tree
Showing 10 changed files with 71 additions and 39 deletions.
22 changes: 19 additions & 3 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ on:
create:
push:
branches:
- 'master'
- 'develop'
- 'v*'
paths-ignore:
- '*.md'
Expand Down Expand Up @@ -91,7 +91,7 @@ jobs:
run: |
BRANCH="${GITHUB_REF##*/}"
CI_TAG=${BRANCH#v}-ci
if [ ${BRANCH} = "master" ]; then
if [ ${BRANCH} = "develop" ]; then
CI_TAG="ci"
fi
echo "TAG=${CI_TAG}" >> $GITHUB_ENV
Expand All @@ -105,6 +105,7 @@ jobs:
images: |
${{ env.IMAGE_ORG }}/cstor-base
quay.io/${{ env.IMAGE_ORG }}/cstor-base
ghcr.io/${{ env.IMAGE_ORG }}/cstor-base
tag-latest: false
tag-custom-only: true
tag-custom: |
Expand Down Expand Up @@ -139,6 +140,13 @@ jobs:
username: ${{ secrets.QUAY_USERNAME }}
password: ${{ secrets.QUAY_TOKEN }}

- name: Login to GHCR
uses: docker/login-action@v1
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}

- name: Build & Push Image
uses: docker/build-push-action@v2
with:
Expand Down Expand Up @@ -176,7 +184,7 @@ jobs:
run: |
BRANCH="${GITHUB_REF##*/}"
CI_TAG=${BRANCH#v}-ci
if [ ${BRANCH} = "master" ]; then
if [ ${BRANCH} = "develop" ]; then
CI_TAG="ci"
fi
echo "TAG=${CI_TAG}" >> $GITHUB_ENV
Expand All @@ -190,6 +198,7 @@ jobs:
images: |
${{ env.IMAGE_ORG }}/cstor-pool
quay.io/${{ env.IMAGE_ORG }}/cstor-pool
ghcr.io/${{ env.IMAGE_ORG }}/cstor-pool
tag-latest: false
tag-custom-only: true
tag-custom: |
Expand Down Expand Up @@ -224,6 +233,13 @@ jobs:
username: ${{ secrets.QUAY_USERNAME }}
password: ${{ secrets.QUAY_TOKEN }}

- name: Login to GHCR
uses: docker/login-action@v1
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}

- name: Build & Push Image
uses: docker/build-push-action@v2
with:
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/pull_request.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,8 +17,8 @@ name: ci
on:
pull_request:
branches:
# on pull requests to master and release branches
- 'master'
# on pull requests to develop and release branches
- 'develop'
- 'v*'
paths-ignore:
- '*.md'
Expand Down
18 changes: 17 additions & 1 deletion .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -52,6 +52,7 @@ jobs:
images: |
${{ env.IMAGE_ORG }}/cstor-base
quay.io/${{ env.IMAGE_ORG }}/cstor-base
ghcr.io/${{ env.IMAGE_ORG }}/cstor-base
tag-latest: true
tag-semver: |
{{version}}
Expand Down Expand Up @@ -85,6 +86,13 @@ jobs:
username: ${{ secrets.QUAY_USERNAME }}
password: ${{ secrets.QUAY_TOKEN }}

- name: Login to GHCR
uses: docker/login-action@v1
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}

- name: Build & Push Image
uses: docker/build-push-action@v2
with:
Expand Down Expand Up @@ -132,6 +140,7 @@ jobs:
images: |
${{ env.IMAGE_ORG }}/cstor-pool
quay.io/${{ env.IMAGE_ORG }}/cstor-pool
ghcr.io/${{ env.IMAGE_ORG }}/cstor-pool
tag-latest: true
tag-semver: |
{{version}}
Expand Down Expand Up @@ -165,6 +174,13 @@ jobs:
username: ${{ secrets.QUAY_USERNAME }}
password: ${{ secrets.QUAY_TOKEN }}

- name: Login to GHCR
uses: docker/login-action@v1
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }}

- name: Build & Push Image
uses: docker/build-push-action@v2
with:
Expand Down Expand Up @@ -194,4 +210,4 @@ jobs:
m-exporter
istgt
# GR_TOKEN secret is the access token to perform github releases
github-token: ${{ secrets.GR_TOKEN }}
github-token: ${{ secrets.GR_TOKEN }}
4 changes: 2 additions & 2 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ You can contribute to libcstor by filling an issue at [openebs/libcstor](https:/

* If you want to file an issue for bug or feature request, please see [Filing an issue](#filing-an-issue)
* If you are a first-time contributor, please see [Steps to Contribute](#steps-to-contribute) and code standard(code-standard.md).
* If you would like to work on something more involved, please connect with the OpenEBS Contributors. See [OpenEBS Community](https://github.com/openebs/openebs/tree/master/community)
* If you would like to work on something more involved, please connect with the OpenEBS Contributors. See [OpenEBS Community](https://github.com/openebs/openebs/tree/HEAD/community)

## Filing an issue
### Before filing an issue
Expand Down Expand Up @@ -94,7 +94,7 @@ For setting up a development environment on your local machine, see the detailed
## Code Reviews
All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult [GitHub Help](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-pull-requests) for more information on using pull requests.

* If your PR is not getting reviewed or you need a specific person to review it, please reach out to the OpenEBS Contributors. See [OpenEBS Community](https://github.com/openebs/openebs/tree/master/community)
* If your PR is not getting reviewed or you need a specific person to review it, please reach out to the OpenEBS Contributors. See [OpenEBS Community](https://github.com/openebs/openebs/tree/HEAD/community)

* If PR is fixing any issues from [github-issues](github.com/openebs/libcstor/issues) then you need to mention the issue number with a link in the PR description. like: _fixes https://github.com/openebs/libcstor/issues/56_

Expand Down
2 changes: 1 addition & 1 deletion GOVERNANCE.md
Original file line number Diff line number Diff line change
@@ -1,2 +1,2 @@
This is a OpenEBS sub project and abides by the
[OpenEBS Project Governance](https://github.com/openebs/openebs/blob/master/GOVERNANCE.md).
[OpenEBS Project Governance](https://github.com/openebs/openebs/blob/HEAD/GOVERNANCE.md).
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fopenebs%2Flibcstor.svg?type=shield)](https://app.fossa.io/projects/git%2Bgithub.com%2Fopenebs%2Flibcstor?ref=badge_shield)
[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/2765/badge)](https://bestpractices.coreinfrastructure.org/projects/2765)
[![Releases](https://img.shields.io/github/v/release/openebs/libcstor.svg?include_prereleases&style=flat-square)](https://github.com/openebs/libcstor/releases)
[![LICENSE](https://img.shields.io/github/license/openebs/libcstor.svg?style=flat-square)](https://github.com/openebs/libcstor/blob/master/LICENSE)
[![LICENSE](https://img.shields.io/github/license/openebs/libcstor.svg?style=flat-square)](https://github.com/openebs/libcstor/blob/develop/LICENSE)

Library to serve IOs on ZVOL over network connections

Expand Down
6 changes: 3 additions & 3 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Once all the above tests are completed, a main release tagged image is published

libcstor is released as a container image with a versioned tag.

Before creating a release, the repo owner needs to create a separate branch from the active branch, which is `master`. Name of the branch should follow the naming convention of `v.1.9.x` if release is for v1.9.0.
Before creating a release, the repo owner needs to create a separate branch from the active branch, which is `develop`. Name of the branch should follow the naming convention of `v.1.9.x` if release is for v1.9.0.

Once the release branch is created, changelog from `changelogs/unreleased` needs to be moved to release specific folder `changelogs/v1.9.x`, if release branch is `v1.10.x` then folder will be `changelogs/v1.10.x`.

Expand All @@ -41,12 +41,12 @@ https://quay.io/repository/openebs/cstor-pool-arm64?tab=tags
https://hub.docker.com/r/openebs/cstor-pool-arm64/tags
```

Once a release is created, update the release description with the changelog mentioned in folder `changelog/v1.9.x`. Once the changelogs are updated in the release, the repo owner needs to create a PR to `master` with the following details:
Once a release is created, update the release description with the changelog mentioned in folder `changelog/v1.9.x`. Once the changelogs are updated in the release, the repo owner needs to create a PR to `develop` with the following details:
1. update the changelog from folder `changelog/v1.9.x` to file `libcstor/CHANGELOG-v1.9.md`
2. If a release is an RC tag then PR should include the changes to remove the changelog from folder`changelog/v1.9.x` which are already mentioned in `libcstor/CHANGELOG-v1.9.md` as part of step number 1.
3. If a release is not an RC tag then
- PR should include the changes to remove files from `changelog/v1.9.x` folder.
- PR should update the root [CHANGELOG file](https://github.com/openebs/libcstor/blob/master/CHANGELOG.md) with contents of file `libcstor/CHANGELOG-v1.9.md`
- PR should update the root [CHANGELOG file](https://github.com/openebs/libcstor/blob/develop/CHANGELOG.md) with contents of file `libcstor/CHANGELOG-v1.9.md`

Format of the `libcstor/CHANGELOG-v1.9.md` file must be as below:
```
Expand Down
2 changes: 1 addition & 1 deletion buildscripts/install-test-dep.sh
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ cd ..
# we need cstor headers
git clone "https://github.com/${REPO_ORG}/cstor.git"
cd cstor || exit 1
if [ "${BRANCH}" == "master" ]; then
if [ "${BRANCH}" == "develop" ]; then
git checkout develop
else
git checkout "${BRANCH}" || git checkout develop
Expand Down
2 changes: 1 addition & 1 deletion code-standard.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

## Sign your commits

We use the Developer Certificate of Origin (DCO) as an additional safeguard for the OpenEBS projects. This is a well established and widely used mechanism to assure that contributors have confirmed their right to license their contribution under the project's license. Please read [dcofile](https://github.com/openebs/openebs/blob/master/contribute/developer-certificate-of-origin). If you can certify it, then just add a line to every git commit message:
We use the Developer Certificate of Origin (DCO) as an additional safeguard for the OpenEBS projects. This is a well established and widely used mechanism to assure that contributors have confirmed their right to license their contribution under the project's license. Please read [dcofile](https://github.com/openebs/openebs/blob/HEAD/contribute/developer-certificate-of-origin). If you can certify it, then just add a line to every git commit message:

````
Signed-off-by: Random J Developer <[email protected]>
Expand Down
48 changes: 24 additions & 24 deletions developer-setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ git clone https://github.com/$user/libcstor.git
cd libcstor
git remote add upstream https://github.com/openebs/libcstor.git

# Never push to upstream master
# Never push to upstream develop
git remote set-url --push upstream no_push

# Confirm that your remotes make sense:
Expand Down Expand Up @@ -99,7 +99,7 @@ git remote -v

* Test your changes

Integration tests are written in c and c+. Test script is maintained at https://github.com/openebs/libcstor/blob/master/tests/cstor/script/test_uzfs.sh
Integration tests are written in c and c+. Test script is maintained at https://github.com/openebs/libcstor/blob/HEAD/tests/cstor/script/test_uzfs.sh
To run the run the integration tests go to cstor directory and run below command.
```sh
../libcstor/tests/cstor/script/test_uzfs.sh -T all
Expand All @@ -114,15 +114,15 @@ Open a terminal on your local machine. Change directory to the libcstor fork roo
$ cd libcstor
```

Check out the master branch.
Check out the develop branch.

```sh
$ git checkout master
Switched to branch 'master'
Your branch is up-to-date with 'origin/master'.
$ git checkout develop
Switched to branch 'develop'
Your branch is up-to-date with 'origin/develop'.
```

Recall that origin/master is a branch on your remote GitHub repository.
Recall that origin/develop is a branch on your remote GitHub repository.
Make sure you have the upstream remote openebs/libcstor by listing them.

```sh
Expand All @@ -138,60 +138,60 @@ $ cd libcstor
```sh
$ git remote add upstream https://github.com/openebs/libcstor.git
```
Fetch all the changes from the upstream master branch.
Fetch all the changes from the upstream develop branch.

```sh
$ git fetch upstream master
$ git fetch upstream develop
remote: Counting objects: 141, done.
remote: Compressing objects: 100% (29/29), done.
remote: Total 141 (delta 52), reused 46 (delta 46), pack-reused 66
Receiving objects: 100% (141/141), 112.43 KiB | 0 bytes/s, done.
Resolving deltas: 100% (79/79), done.
From github.com:openebs/libcstor
* branch master -> FETCH_HEAD
* branch develop -> FETCH_HEAD
```

Rebase your local master with the upstream/master.
Rebase your local develop with the upstream/develop.

```sh
$ git rebase upstream/master
$ git rebase upstream/develop
First, rewinding head to replay your work on top of it...
Fast-forwarded master to upstream/master.
Fast-forwarded develop to upstream/develop.
```
This command applies all the commits from the upstream master to your local master.
This command applies all the commits from the upstream develop to your local develop.

Check the status of your local branch.

```sh
$ git status
On branch master
Your branch is ahead of 'origin/master' by 12 commits.
On branch develop
Your branch is ahead of 'origin/develop' by 12 commits.
(use "git push" to publish your local commits)
nothing to commit, working directory clean
```
Your local repository now has all the changes from the upstream remote. You need to push the changes to your remote fork which is origin master.
Your local repository now has all the changes from the upstream remote. You need to push the changes to your remote fork which is origin develop.

Push the rebased master to origin master.
Push the rebased develop to origin develop.

```sh
$ git push origin master
$ git push origin develop
Username for 'https://github.com': $user
Password for 'https://[email protected]':
Counting objects: 223, done.
Compressing objects: 100% (38/38), done.
Writing objects: 100% (69/69), 8.76 KiB | 0 bytes/s, done.
Total 69 (delta 53), reused 47 (delta 31)
To https://github.com/$user/libcstor.git
8e107a9..5035fa1 master -> master
8e107a9..5035fa1 develop -> develop
```

### Contributing to a feature or bugfix.

Always start with creating a new branch from master to work on a new feature or bugfix. Your branch name should have the format XX-descriptive where XX is the issue number you are working on followed by some descriptive text. For example:
Always start with creating a new branch from develop to work on a new feature or bugfix. Your branch name should have the format XX-descriptive where XX is the issue number you are working on followed by some descriptive text. For example:

```sh
$ git checkout master
# Make sure the master is rebased with the latest changes as described in the previous step.
$ git checkout develop
# Make sure the develop is rebased with the latest changes as described in the previous step.
$ git checkout -b 1234-fix-developer-docs
Switched to a new branch '1234-fix-developer-docs'
```
Expand All @@ -204,7 +204,7 @@ Happy Hacking!
```sh
# While on your myfeature branch (see above)
git fetch upstream
git rebase upstream/master
git rebase upstream/develop
```

While you rebase your changes, you must resolve any conflicts that might arise and build and test your changes using the above steps.
Expand Down

0 comments on commit 6f449fc

Please sign in to comment.