.travis.yml

os: linux
dist: bionic
language: python
python:
  - 3.7
git:
  ## depth set to false overrides travis default behavior to use shallow clones
  ## with depth 50 that can cause issues
  ##
  ## ref: https://github.com/jupyterhub/chartpress#shallow-clones
  ##
  depth: false
services:
  - docker

stages:
  - name: publish
    if: tag IS present OR ( branch IN (master) AND type IN (push) )
  - name: test

before_install:
  # Exit immediately if a command exits with a non-zero status.
  - set -e
  - . ci/common
  # NOTE: The latest docker python package (4.3.0) requires a more modern docker
  #       version (newer than 18.06.0-ce / API version: 1.38) which is not yet
  #       available on travis.
  - pip install "docker~=4.2.0"

# The default install script below will prepare a k8s cluster to work with, but
# not install JupyterHub itself, as upgrade tests may want to make multiple
# installations in sequence etc.
install:
  # Fix to avoid rebuilding images already built
  - remove_docker_mirror_on_travis

  # Setup our k3s based Kubernetes cluster and use its kubectl as well
  - setup_k3s
  - setup_helm
  - helm repo add jupyterhub https://jupyterhub.github.io/helm-chart/
  - helm repo update

  # Install a local ACME server
  - helm install pebble jupyterhub/pebble --values dev-config-pebble.yaml

  # Build our images if needed and update values.yaml with the tags
  - pip3 install --no-cache-dir -r dev-requirements.txt
  - chartpress

  # Pre-install JupyterHub
  - await_dns     # part of k3s, jupyterhub needs it while referencing https://pebble/dir
  - await_calico  # installed with setup_k3s, enforces netpol
  - await_pebble  # jupyterhub's autohttps communicates with it as the ACME server
script:
  # Install JupyterHub
  - helm install jupyterhub ./jupyterhub --values dev-config.yaml
  - await_jupyterhub
  - await_autohttps_tls_cert_acquisition

  # Run tests
  - pytest --verbose --exitfirst ./tests || (full_namespace_report && exit 1)

env:
  ## Global environment variables will act as defaults, jobs will override them
  ## k3s versions:  https://github.com/rancher/k3s/releases
  ## helm versions: https://github.com/helm/helm/releases
  global:
    - K3S_VERSION=v1.19.3+k3s1
    - HELM_VERSION=v3.3.4

jobs:
  ## don't wait for the jobs that are allowed to fail to report success
  ##
  ## ref: https://docs.travis-ci.com/user/customizing-the-build/#rows-that-are-allowed-to-fail
  ## ref: https://docs.travis-ci.com/user/customizing-the-build/#fast-finishing
  ##
  allow_failures:
    - name: docs:link-check
  fast_finish: true

  ## define individual jobs that can rely on defaults from above
  include:
    - stage: test
      name: chart:lint-and-validate
      install:
        - setup_helm
        - setup_kubeval
        - pip install yamllint
      script:
        # NOTE: Kubernetes resource validation can only be done against
        #       Kubernetes versions with schemas available in:
        #       https://github.com/instrumenta/kubernetes-json-schema
        #
        # NOTE: The "helm template" command will evaluate
        #       .Capabilities.APIVersion.Has in templates based on a Kubernetes
        #       version associated with the helm binary's version. Since we
        #       render the templates with a specific helm version, we end up
        #       rendering templates using a mocked k8s version unrelated to the
        #       Kubernetes version we want to validate against. This issue has
        #       made us not validate against versions lower than 1.14.
        - tools/templates/lint-and-validate.py --kubernetes-versions 1.14.0,1.18.0

    - stage: test
      name: chart:install-latest-then-upgrade
      script:
        # Install latest JupyterHub version from Helm chart repo
        - helm install jupyterhub jupyterhub/jupyterhub --values dev-config.yaml
        - await_jupyterhub
        - await_autohttps_tls_cert_acquisition

        # Upgrade to local Helm chart
        - helm upgrade jupyterhub ./jupyterhub --values dev-config.yaml
        - await_jupyterhub

        # Run tests
        - pytest --verbose --exitfirst ./tests || (full_namespace_report && exit 1)

    ## k3s versions:  https://github.com/rancher/k3s/releases
    - stage: test
      name: chart:k8s-1.19

    - stage: test
      name: chart:k8s-1.18
      env: K3S_VERSION=v1.18.10+k3s1

    - stage: test
      name: chart:k8s-1.17
      env: K3S_VERSION=v1.17.13+k3s1

    - stage: test
      name: chart:k8s-1.16
      env: K3S_VERSION=v1.16.15+k3s1 k3s_disable_command=--no-deploy

    - stage: test
      name: docs:link-check
      install:
        - pip install --no-cache-dir -r doc/doc-requirements.txt
      script:
        - cd doc
        - make html SPHINXOPTS='-W --keep-going'
        - make linkcheck

    - stage: publish
      name: publish:helm-chart
      install:
        - pip install --no-cache-dir -r dev-requirements.txt
      script:
        - setup_helm
        - remove_docker_mirror_on_travis
        - ./ci/publish
      env:
        ## encrypted environment variables DOCKER_USERNAME and DOCKER_PASSWORD,
        ## used in the publish script to push built docker images to docker hub.
        ##
        ## ref: https://docs.travis-ci.com/user/environment-variables/#encrypting-environment-variables
        - secure: jpFpbMccpjGP+otWH2Z03VFdtR9AAu2vzrNxsoZ3IvJvrO4MfzYJ3uSCDQuB0NG9gBgaAscpTJtliPTEi7njXHLcsFeWXLUmeBEHLozYxfzDQzMvW3EYdNWcC7oVAAt3de0i0ojw9rGswiofhbu2dAe+Xd2bejv1+PVJcEC3SRPGy17kb6bme6gD3zty5ft4VpzP0nomUNqfZBRLUYxSZuKlHJaZ6Nuq434rKmXrcN6uy+eEWDorTbjyM22IIYgUmrhg++Qtu/MBR7/rriPhyRltCU14361bcxqyq2Hw+HNG8D3hsqo5TiEiYwxOQcXRgddL+Ci6/y0L1EvqOQc+1V8ycwNs2oNicwNgSn5A+9HpF495Kae039hGtj2Gpt4IbplSYwKFq/sFTq+CekxdD2YVQmGvsjep4bNVL66o2RSZVAW1Bg/G8/sSe3BwgD8IToy9+1NHPPuaVupeukRqNyUDcVvWH8hdb8AkXYY87+546etYDpn91GQnhTEberKbXX4UCmpKNXpXoprLE8nQLGb6TIoHPTyA+RRNQ4erDzMjqF43UVmhOZTtkGaRgIWK7vDAKpLUnuOguuhJUNpYpRggGQsMV8cZnaCumy5OFUf6i6rfN0Ru6a+/Bm7grJiAcnZlU7igaxgI38QaJgCKcqqzIImdcRYNQC74/Ok/1oM=
        - secure: BK++GwKVPoS0iG8aB7wQ13daTgJR9MifHA+l9xr/tSZ3SUL6nc7kjxLbliRQJCqT9lcOODsd+v2u9PziEzBp0CCh67ftFxJw8riP2+FgdmHTK4yav9QpSwoBJHhV2SgBMGlXiqdUVC7wpgjzzK63V8abvzAhXkthWPl3kYpUI//xGYyuBNXVHEOImHB3F1M5bn90lflFtRfq2iH5FigGesMi2BFfTVeqvbzZVZrAs0E1/NRdO+/cRq0c9aRpNLkh254k1tcKbUvULQq1iLQuHN2Ramn3NgNnx93sbwp1e7ZjmETbjr9cwMIDg5mh25H0Rjf2Nn8cqHbBCWzoMkjZW097HRVDYht2kJZQIbQcaxX38DW6vykUwGWSBAWbtvCUwYwU57s/dIbSYUTQErkYYmhiq52cdOtnxZ2/ULoElCVyR8lTmQuANJrq9YFC9q1ly69YuMWWnFgwxWpK1JCgAJGELgj5EvcghEtNmkEFh5f6pmbKBE7PKQPTovzNKcdRauR/L+MsmhVYukCfNZq57LrruIQIX1GQNw9w3Ck8P4EPtNjdI4umCSy6nZSyTevWgVTmIP9EwXa5Cap32ZU+iDtw+wUBAr3sjROJOYGKlL/ktWsWbjog5hIG0rrb8PbgOfbLRZSEYGL9sYsyXXyW5oI37lB7AqG6D7vOA4TdmTQ=