Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 8 additions & 2 deletions .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -52,10 +52,16 @@ repos:
rev: v6.2.1
hooks:
- id: beautysh
additional_dependencies:
# On recent Python versions beautysh fails with
# ModuleNotFoundError: No module named 'pkg_resources'
# This can be removed if https://github.com/lovesegfault/beautysh/pull/251
# is released
- setuptools

# Autoformat: markdown, yaml (but not helm templates)
- repo: https://github.com/pre-commit/mirrors-prettier
rev: v4.0.0-alpha.8
- repo: https://github.com/rbubley/mirrors-prettier
rev: v3.6.2
hooks:
- id: prettier

Expand Down
4 changes: 0 additions & 4 deletions RELEASE.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,6 @@ Also the images we build are based on some image specified in the `FROM` stateme
## Pre-release iteration

- Update `docs/source/changelog.md`

- [ ] Generate a list of PRs using [executablebooks/github-activity](https://github.com/executablebooks/github-activity)
```bash
github-activity --output github-activity-output.md --since <last tag> jupyterhub/zero-to-jupyterhub-k8s
Expand All @@ -60,7 +59,6 @@ Also the images we build are based on some image specified in the `FROM` stateme
- [ ] Summarize the release changes

- Tag a x.y.z-beta.1 release

- [ ] Create and push a git tag
```bash
git checkout main
Expand All @@ -75,15 +73,13 @@ Also the images we build are based on some image specified in the `FROM` stateme
## Final release

- Update `docs/source/changelog.md`

- [ ] Generate a list of merged PRs and a list of contributors and update the changelog.
```bash
github-activity --output github-activity-output.md --since <last tag> jupyterhub/zero-to-jupyterhub-k8s
```
- [ ] Link out to the downstream projects within the JupyterHub org to celebrate work done there as well.

- Release

- [ ] Create and push a git tag.

```bash
Expand Down
1 change: 0 additions & 1 deletion docs/source/administrator/optimization.md
Original file line number Diff line number Diff line change
Expand Up @@ -270,7 +270,6 @@ following:

If you need help on how to do this, please refer to your cloud providers
documentation. A node pool may be called a node group.

- The label: `hub.jupyter.org/node-purpose=user`

**NOTE**: Cloud providers often have their own labels, separate from
Expand Down
3 changes: 0 additions & 3 deletions docs/source/changelog.md
Original file line number Diff line number Diff line change
Expand Up @@ -1081,7 +1081,6 @@ and small bugfixes will increment the three version numbers.
you if you don't specify them.

- **Smoother helm upgrades**

- `prePuller.hook.pullOnlyOnChanges` is now available and enabled by default,
which only intercepts a `helm upgrade` by pulling images if they have
changed since the last upgrade.
Expand Down Expand Up @@ -1131,7 +1130,6 @@ followed these instructions between `0.7.0-beta.1` and `0.11.1`, please see the
cluster.

The most common validation errors are:

- _Unrecognized config values_

For example if you have misspelled something.
Expand Down Expand Up @@ -4148,7 +4146,6 @@ Deployer UX fixes.
- No need to restart hub manually after some changes - it is
automatically restarted now. You can disable an automatic
restart of hub after an upgrade with the following:

1. Finding out the current helm release's revision
2. Adding '--set revisionOverride=<current-revision>' to your
upgrade command.
Expand Down
1 change: 0 additions & 1 deletion docs/source/jupyterhub/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,7 +75,6 @@ can try with `nano config.yaml`.
```

where:

- `<helm-release-name>` refers to a [Helm release name](https://helm.sh/docs/glossary/#release), an identifier used to
differentiate chart installations. You need it when you are changing or
deleting the configuration of this chart installation. If your Kubernetes
Expand Down
1 change: 0 additions & 1 deletion docs/source/jupyterhub/uninstall.md
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,6 @@ before doing the cloud provider specific setup.
has been deleted.

At a minimum, check the following under the Hamburger (left top corner) menu:

1. Compute -> Compute Engine -> Disks
2. Compute -> Kubernetes Engine -> Clusters
3. Tools -> Container Registry -> Images
Expand Down
1 change: 0 additions & 1 deletion docs/source/kubernetes/amazon/step-zero-aws-eks.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@ This guide uses AWS to set up a cluster. This mirrors the steps found at [Gettin
Instructions for creating a role can be found
[here](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html).
It should have the following policies:

- AmazonEKSClusterPolicy
- AmazonEKSServicePolicy
- AmazonEC2ContainerRegistryReadOnly
Expand Down
4 changes: 0 additions & 4 deletions docs/source/kubernetes/amazon/step-zero-aws.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,6 @@ template you will use to setup and shape your cluster.
resources on AWS. Instructions for creating a role can be found
[here](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html).
The following policies are required:

- AmazonEC2FullAccess
- IAMFullAccess
- AmazonS3FullAccess
Expand All @@ -41,7 +40,6 @@ template you will use to setup and shape your cluster.
[here](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/connect-linux-inst-ssh.html).

4. Install kops and kubectl on your CI host

- Follow the instructions here: <https://github.com/kubernetes/kops/blob/HEAD/docs/install.md>

5. Choose a cluster name:
Expand Down Expand Up @@ -172,7 +170,6 @@ template you will use to setup and shape your cluster.
You should see a list of two nodes, each beginning with `ip`.

If you want to use kubectl and helm locally:

- run the following on CI host: `kops export kubecfg`
- copy the contents of `~/.kube/config` to the same place on your local system

Expand All @@ -189,7 +186,6 @@ template you will use to setup and shape your cluster.
Instead we need to follow this guide: <https://github.com/kubernetes/kops/blob/HEAD/docs/examples/kops-tests-private-net-bastion-host.md#adding-a-bastion-host-to-our-cluster>

At this point there are a few public endpoints left open which need to be addressed

- Bastion ELB security group defaults to access from 0.0.0.0
- API ELB security group defaults to access from 0.0.0.0

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,6 @@ This page describes the commands required to setup a Kubernetes cluster using th
If you prefer to use the Digital Ocean portal see the [Digital Ocean Get Started](https://www.digitalocean.com/products/kubernetes).

1. Prepare your Digital Ocean shell environment.

1. **Install command-line tools locally**. You'll need at least v1.13.0.

You can either follow the [installation instructions](https://github.com/digitalocean/doctl/blob/main/README.md) or use the commands below:
Expand Down
2 changes: 0 additions & 2 deletions docs/source/kubernetes/google/step-zero-gcp.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ your google cloud account.
command line interfaces on your own computer's terminal. We recommend
starting out by using the web based terminal. Choose one set of instructions
below.

1. **Use a web based terminal:**

Start _Google Cloud Shell_ from [console.cloud.google.com](https://console.cloud.google.com) by clicking the button shown below.
Expand All @@ -38,7 +37,6 @@ your google cloud account.
```
2. **Use your own computer's terminal:**
1. Download and install the `gcloud` command line tool at its [install
page](https://cloud.google.com/sdk/docs/install). It will help you
create and communicate with a Kubernetes cluster.
Expand Down
2 changes: 0 additions & 2 deletions docs/source/kubernetes/ibm/step-zero-ibm.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,6 @@ Procedure:
Kubernetes Service delivers powerful tools by combining Docker and Kubernetes technologies, an intuitive user experience, and built-in security and isolation to automate the deployment, operation, scaling, and monitoring of containerized apps in a cluster of computing hosts.

To set up the Kubernetes cluster:

1. Create a Kubernetes cluster from the [IBM Cloud catalog](https://cloud.ibm.com/kubernetes/catalog/create)).
2. When configuring the new cluster, select the **Cluster type** and click **Create Cluster** to provision a Kubernetes cluster.
2.1 In the case of a free cluster you will see something similar to:
Expand All @@ -49,7 +48,6 @@ Procedure:

2. Configure kubectl
[kubectl](https://kubernetes.io/docs/reference/kubectl/) is a CLI tool to interact with a Kubernetes cluster. In this occasion, you will use it to point forward to the created Kubernetes cluster.

1. Use `ibmcloud login` to log in interactively into the IBM Cloud. Provide the organization (org), location and space under which the cluster is created. You can reconfirm the details by running `ibmcloud target` command.
2. When the cluster is ready, retrieve the cluster configuration by using the cluster's name:
```
Expand Down
7 changes: 0 additions & 7 deletions docs/source/kubernetes/microsoft/step-zero-azure.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,6 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
1. Prepare your Azure shell environment. You have two options, one is to use
the Azure interactive shell, the other is to install the Azure command-line
tools locally. Instructions for each are below.

- **Using the Azure interactive shell**. The [Azure Portal](https://portal.azure.com)
contains an interactive shell that you can use to communicate with your
Kubernetes cluster. To access this shell, go to [portal.azure.com](https://portal.azure.com)
Expand Down Expand Up @@ -70,7 +69,6 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
```

where:

- `--name` specifies the name of your resource group. We recommend using something
that uniquely identifies this hub. For example, if you are creating a resource group
for UC Berkeley's 2018 Spring Data100 Course, you may give it a
Expand Down Expand Up @@ -137,7 +135,6 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
```

where:

- `--resource-group` is the ResourceGroup you created
- `--name` is the name you want to assign to your virtual network, for example, `hub-vnet`
- `--address-prefixes` are the IP address prefixes for your virtual network
Expand Down Expand Up @@ -208,7 +205,6 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
```

where:

- `--name` is the name you want to use to refer to your cluster
- `--resource-group` is the ResourceGroup you created
- `--ssh-key-value` is the ssh public key created
Expand All @@ -231,7 +227,6 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
This should take a few minutes and provide you with a working Kubernetes cluster!

Optionally, prepare autoscaling, where:

- `--vm-set-type VirtualMachineScaleSets` deploys the cluster as a scale set.
- `--enable-cluster-autoscaler` enables autoscaling feature for your cluster
- `--min-count 3` is the minimum node count
Expand Down Expand Up @@ -289,7 +284,6 @@ If you prefer to use the Azure portal see the [Azure Kubernetes Service quicksta
```

where:

- `--name` is the name you gave your cluster
- `--resource-group` is the ResourceGroup you created

Expand Down Expand Up @@ -327,7 +321,6 @@ RBAC is enabled by default when using the command line tools.
From the left-hand menu, select "Scaling".
Click the blue "Custom autoscale" button and an autogenerated form for a scale condition will appear.
We will add two new rules to this condition:

- Increase the instance count by 1 when the average CPU usage over 10 minutes is greater than 70%
- Decrease the instance count by 1 when the average CPU usage over 10 minutes is less than 5%

Expand Down