Skip to content
Source code for the linkerd.io website
Branch: master
Clone or download
grampelberg Update to fix new slug format (#280)
* Update to fix new slug format

* Address review feedback
Latest commit 63db05d Apr 23, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Publish on merges to master (#202) Feb 28, 2019
.github Initial opening of the linkerd websites Aug 16, 2018
api.linkerd.io Initial opening of the linkerd websites Aug 16, 2018
linkerd.io
run.linkerd.io/public update emojivoto version in manifests (#246) Apr 9, 2019
versioncheck.linkerd.io Remove legacy `version` release channel. (#101) Jan 23, 2019
.dockerignore
.gitignore feat: linkerd blog (#229) Mar 26, 2019
CONTRIBUTING.md Make all links relative (#71) Nov 30, 2018
DCO Initial opening of the linkerd websites Aug 16, 2018
Dockerfile
LICENSE
MAINTAINERS.md Initial opening of the linkerd websites Aug 16, 2018
Makefile Update website for stable-2.3.0 release (#262) Apr 17, 2019
README.md Update set up instructions (#241) Apr 5, 2019
netlify.toml

README.md

linkerd.io

Source code for the linkerd.io website.

General development instructions

  1. Install Hugo:

    for Mac users:

    brew install hugo

    for Linux users:

    download the extended release of Hugo from GitHub, then install the following dependencies:

    curl https://htmltest.wjdp.uk | bash
    npm install -g markdownlint-cli

    make sure they are added to $PATH

  2. From the root /website directory, build site and run Hugo in development mode:

    hugo serve -s linkerd.io
  3. Also in the root directory, run checks on any changes you make:

    make check lint

You should see the site on localhost:1313, and it should reload automatically upon file write.

To change the way the site looks

CSS/HTML

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.

run.linkerd.io

Install scripts for linkerd as well as demo applications such as emojivoto.

versioncheck.linkerd.io

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.linkerd.io

API docs for linkerd1.

Note: this does not deploy by default as part of make publish. It needs to be released separately.

Updating docs from Linkerd

See slate documentation ./build will grab whatever's on master from slate-linkerd and add it to the public dir.

Creating a new release

  1. From the linkerd.io directory, run:

    ./release-next-version <new version>
  2. Run ./release-next-version <release-tag> <new version> in slate-linkerd

  3. Then check locally

    make serve-api.linkerd.io
  4. Finally push to production

    make deploy-api.linkerd.io

Publishing

  1. Make sure your gcloud tooling is up to date:

    gcloud components update
    gcloud auth login
  2. Do a dry run and make sure everything works:

    make publish DRY_RUN=true
  3. Update the website:

    make publish

Notes

  • 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.

If you have to create a new bucket

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://bucketname
gsutil web set -m index.html -e 404.html gs://bucketname

Verifying cache updates

Turn off all caching on all files:

gsutil -m setmeta -r -h "Cache-Control: no-cache, no-store, must-revalidate" gs://linkerd.io/

Turn caching back on:

gsutil -m setmeta -r -h "Cache-Control:" gs://linkerd.io/

Enable access logs (should only need to be run once)

gsutil logging set on -b gs://linkerd2-access-logs -o AccessLog gs://linkerd.io

Get access logs

# note: this will download ALL logs. probably not what you want.
gsutil -m rsync gs://linkerd2-access-logs logs/

Set CORS policy (should only need to be run once)

gsutil cors set versioncheck.linkerd.io.cors.json gs://versioncheck.linkerd.io
You can’t perform that action at this time.