Skip to content

Commit

Permalink
Remove old book location (solana-labs#7621)
Browse files Browse the repository at this point in the history
  • Loading branch information
mvines authored Dec 24, 2019
1 parent 8f0e1f3 commit fad6c72
Show file tree
Hide file tree
Showing 2 changed files with 1 addition and 87 deletions.
19 changes: 0 additions & 19 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,25 +140,6 @@ TODO: Documentation update procedure is WIP as we move to gitbook
Document the new recommended version by updating `book/src/running-archiver.md` and `book/src/validator-testnet.md` on the release (beta) branch to point at the `solana-install` for the upcoming release version.
#### Publish updated Book
We maintain three copies of the "book" as official documentation:
1) "Book" is the documentation for the latest official release. This should get manually updated whenever a new release is made. It is published here:
https://solana-labs.github.io/book/
2) "Book-edge" tracks the tip of the master branch and updates automatically.
https://solana-labs.github.io/book-edge/
3) "Book-beta" tracks the tip of the beta branch and updates automatically.
https://solana-labs.github.io/book-beta/
To manually trigger an update of the "Book", create a new job of the manual-update-book pipeline.
Set the tag of the latest release as the PUBLISH_BOOK_TAG environment variable.
```bash
PUBLISH_BOOK_TAG=v0.16.6
```
https://buildkite.com/solana-labs/manual-update-book

### Update software on testnet.solana.com
The testnet running on testnet.solana.com is set to use a fixed release tag
Expand Down
69 changes: 1 addition & 68 deletions ci/publish-book.sh
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@ me=$(basename "$0")
echo --- update gitbook-cage
if [[ -n $CI_BRANCH ]]; then
(

set -x
(
. ci/rust-version.sh stable
Expand All @@ -25,74 +24,8 @@ if [[ -n $CI_BRANCH ]]; then
git reset --hard HEAD~
fi
)
fi


source ci/rust-version.sh stable
eval "$(ci/channel-info.sh)"

if [[ -n $PUBLISH_BOOK_TAG ]]; then
CURRENT_TAG="$(git describe --tags)"
COMMIT_TO_PUBLISH="$(git rev-list -n 1 "${PUBLISH_BOOK_TAG}")"

# book is manually published at a specified release tag
if [[ $PUBLISH_BOOK_TAG != "$CURRENT_TAG" ]]; then
(
cat <<EOF
steps:
- trigger: "$BUILDKITE_PIPELINE_SLUG"
async: true
build:
message: "$BUILDKITE_MESSAGE"
commit: "$COMMIT_TO_PUBLISH"
env:
PUBLISH_BOOK_TAG: "$PUBLISH_BOOK_TAG"
EOF
) | buildkite-agent pipeline upload
exit 0
fi
[email protected]:solana-labs/book.git
BOOK="book"
else
# book-edge and book-beta are published automatically on the tip of the branch
case $CHANNEL in
edge)
[email protected]:solana-labs/book-edge.git
;;
beta)
[email protected]:solana-labs/book-beta.git
;;
*)
echo "--- publish skipped"
exit 0
;;
esac
BOOK=$CHANNEL
echo CI_BRANCH not set
fi

ci/docker-run.sh "$rust_stable_docker_image" bash -exc "book/build.sh"

echo --- create book repo
(
set -x
cd book/html/
git init .
git add ./* ./.nojekyll
git config user.email [email protected]
git config user.name "$me"
git commit -m "${CI_COMMIT:-local}"
)

echo "--- publish $BOOK"
(
cd book/html/
git remote add origin $repo
git fetch origin master
if ! git diff HEAD origin/master --quiet; then
git push -f origin HEAD:master
else
echo "Content unchanged, publish skipped"
fi
)

exit 0

0 comments on commit fad6c72

Please sign in to comment.