2018-07-11 22:49:23 -06:00
|
|
|
Docker image containing rust nightly and some preinstalled crates used in CI.
|
|
|
|
|
|
2018-08-20 09:59:26 -07:00
|
|
|
This image may be manually updated by running `CI=true ./build.sh` if you are a member
|
2018-07-11 22:49:23 -06:00
|
|
|
of the [Solana Labs](https://hub.docker.com/u/solanalabs/) Docker Hub
|
2020-06-17 01:32:16 +09:00
|
|
|
organization.
|
2018-08-20 09:59:26 -07:00
|
|
|
|
|
|
|
|
## Moving to a newer nightly
|
|
|
|
|
|
2020-06-17 01:32:16 +09:00
|
|
|
NOTE: Follow instructions in docker-rust/README.md before this when updating the stable
|
|
|
|
|
rust version as well.
|
|
|
|
|
|
2018-09-04 17:03:26 -06:00
|
|
|
We pin the version of nightly (see the `ARG nightly=xyz` line in `Dockerfile`)
|
2018-08-20 09:59:26 -07:00
|
|
|
to avoid the build breaking at unexpected times, as occasionally nightly will
|
|
|
|
|
introduce breaking changes.
|
|
|
|
|
|
|
|
|
|
To update the pinned version:
|
2020-06-17 01:32:16 +09:00
|
|
|
1. Edit `Dockerfile` to match the desired stable rust version to base on if needed.
|
2018-09-07 16:41:55 -07:00
|
|
|
1. Run `ci/docker-rust-nightly/build.sh` to rebuild the nightly image locally,
|
|
|
|
|
or potentially `ci/docker-rust-nightly/build.sh YYYY-MM-DD` if there's a
|
|
|
|
|
specific YYYY-MM-DD that is desired (default is today's build).
|
2020-03-13 13:15:22 -07:00
|
|
|
Check https://rust-lang.github.io/rustup-components-history/ for build
|
|
|
|
|
status
|
2020-08-14 09:36:04 -07:00
|
|
|
1. Update `ci/rust-version.sh` to reflect the new nightly `YYYY-MM-DD`
|
2020-06-17 01:32:16 +09:00
|
|
|
1. Run `SOLANA_ALLOCATE_TTY=1 SOLANA_DOCKER_RUN_NOSETUID=1 ci/docker-run.sh --nopull solanalabs/rust-nightly:YYYY-MM-DD ci/test-checks.sh`
|
|
|
|
|
and `SOLANA_ALLOCATE_TTY=1 SOLANA_DOCKER_RUN_NOSETUID=1 ci/docker-run.sh --nopull solanalabs/rust-nightly:YYYY-MM-DD ci/test-coverage.sh [args]...`
|
2018-09-07 16:41:55 -07:00
|
|
|
to confirm the new nightly image builds. Fix any issues as needed
|
2018-09-04 17:03:26 -06:00
|
|
|
1. Run `docker login` to enable pushing images to Docker Hub, if you're authorized.
|
2018-09-07 16:41:55 -07:00
|
|
|
1. Run `CI=true ci/docker-rust-nightly/build.sh YYYY-MM-DD` to push the new nightly image to dockerhub.com.
|
2019-06-20 07:43:31 -07:00
|
|
|
1. Send a PR with the `ci/rust-version.sh` change and any codebase adjustments needed.
|
2018-09-04 17:03:26 -06:00
|
|
|
|
|
|
|
|
## Troubleshooting
|
|
|
|
|
|
|
|
|
|
### Resource is denied
|
|
|
|
|
|
|
|
|
|
When running `CI=true ci/docker-rust-nightly/build.sh`, you see:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
denied: requested access to the resource is denied
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Run `docker login` to enable pushing images to Docker Hub. Contact @mvines or @garious
|
|
|
|
|
to get write access.
|
