Source code for the linkerd.io website.
-
Run the linter and checker:
docker run \ --mount type=bind,source="$(pwd)",target=/website --workdir=/website \ buoyantio/website-builder:v1.3.3 sh -c "make lint check"
-
Install Hugo 0.74.3 to run the site locally:
For Mac users:
brew install hugo
For Linux users, download the extended release of Hugo from its GitHub release page.
-
From the root
/website
directory, build site and run Hugo in development mode:hugo serve -s linkerd.io
You should see the site on localhost:1313, and it should reload automatically upon file write.
Images and static CSS and JavaScript files are located in the static
directory. These files are served as-is. Some of the site's CSS, however, is
generated from Sass sources in assets/scss
by
Hugo. When you change those files, Hugo updates the CSS for the site
automatically and refreshes the page.
The files in layouts/ are the HTML for the site (including layout/index.html for the front page.) These files are Go templates with a couple extra Hugo goodies thrown in. See the hugo documentation for details.
If you're running hugo server
(see above) then updates should be reflected in
your browser window via some fancy javascript magic.
Install scripts for linkerd as well as demo applications such as emojivoto.
Location for existing installations to check and see if they're up to date or not.
To build and serve against the latest Linkerd2 release:
make serve-versioncheck.linkerd.io
API docs for linkerd1.
Note: this does not deploy by default as part of make publish
. It needs to be
released separately.
See slate documentation ./build
will grab whatever's on
main from slate-linkerd and add it to the public dir.
-
From the linkerd.io directory, run:
./release-next-version <new version>
-
Run
./release-next-version <release-tag> <new version>
in slate-linkerd -
Then check locally
make serve-api.linkerd.io
-
Finally push to production
make deploy-api.linkerd.io
- NB: If you're running macOS 10.14+ with
ruby
installed by XCode, you may have to set the SDKROOT in order to installjson 1.8.3
which is amiddleman
dependency.
- NB: If you're running macOS 10.14+ with
-
Make sure your gcloud tooling is up to date:
gcloud components update gcloud auth login
-
Do a dry run and make sure everything works:
make publish DRY_RUN=true
-
Update the website:
make publish
-
This does not update api.linkerd.io, see the section for that specifically to update it.
-
There is no caching in front of run.linkerd.io and versioncheck.linkerd.io. You should see updates there immediately.
-
There is caching for non-html pages in front of linkerd.io. If you're updating a non-html page for linkerd.io, it might be worth flushing the cache (cloudflare) and waiting awhile.
You probably won't have to do this, but if you do, don't forget to do this stuff too to set up the bucket for public serving:
gsutil defacl ch -u AllUsers:R gs:https://bucketname
gsutil web set -m index.html -e 404.html gs:https://bucketname
Turn off all caching on all files:
gsutil -m setmeta -r -h "Cache-Control: no-cache, no-store, must-revalidate" gs:https://linkerd.io/
Turn caching back on:
gsutil -m setmeta -r -h "Cache-Control:" gs:https://linkerd.io/
gsutil logging set on -b gs:https://linkerd2-access-logs -o AccessLog gs:https://linkerd.io
# note: this will download ALL logs. probably not what you want.
gsutil -m rsync gs:https://linkerd2-access-logs logs/
gsutil cors set versioncheck.linkerd.io.cors.json gs:https://versioncheck.linkerd.io