Skip to content

Commit

Permalink
added RELEASE.md file with developer release instructions. reset chan…
Browse files Browse the repository at this point in the history
…gelog
  • Loading branch information
colindickson committed Oct 26, 2023
1 parent 1969160 commit 8ede5ad
Show file tree
Hide file tree
Showing 2 changed files with 23 additions and 6 deletions.
6 changes: 0 additions & 6 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,7 +1 @@
## 1.25.0-rc.1-dm

* Merged `neard` version `1.25.0-rc.1`.

## 1.24.0-dm

* Merged `neard` version `1.24.0`.
23 changes: 23 additions & 0 deletions RELEASE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
## Developer Release Guide

When a new version of nearcore is released, the near-firehose-indexer should be updated to use the latest version of nearcore. This is done by updating the `Cargo.toml` file to point to the new version of nearcore.

Once this is done, compile the project locally using `make release` and check that the project compiles locally. This is important, because the Github action takes about 30 minutes to compile, and so compiling locally allows you to potentially save a lot of time.

After you have validated that the project compiles locally, tag your commit with the following format: `{{nearcore-tag}}-fire`.

The Github action will then compile the project and push the docker image to Dockerhub. This image can then be used in the `firehose-near` project's Github action to build the bundle image.

### Example:

Let's say Near releases a new version of nearcore with tag `1.99.0-rc.3`
1. Update the `Cargo.toml` file package version to `1.99.0-rc.3`
2. In `Cargo.toml`, update all `nearcore` dependencies' `rev` tag to `1.99.0-rc.3`
3. Run `make release` locally to validate that the project compiles
4. Commit changes and tag commit with `1.99.0-rc.3-fire`
5. Push commit.

### Notes

* When nearcore releases a new set of release candidates (ie: an `-rc.1` release), this usually involves many more changes than a normal release. Normally, you will need to also update the `rust-toolchain.toml` file to match their version.
* If compilation still fails, then you will need to dig deeper into the reasons why. Start with the compilaton errors and work backwards from there. One thing you might try is to git checkout the original nearcore project at the given tag, and try to compile their project.

0 comments on commit 8ede5ad

Please sign in to comment.