Skip to content

Commit

Permalink
update README.md
Browse files Browse the repository at this point in the history
Signed-off-by: Marques Johansson <marques@packet.com>
  • Loading branch information
displague committed Sep 6, 2022
1 parent ed51d7b commit f859b99
Show file tree
Hide file tree
Showing 2 changed files with 15 additions and 43 deletions.
43 changes: 0 additions & 43 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,49 +10,6 @@ This is the official [cluster-api](https://github.com/kubernetes-sigs/cluster-ap

![Packetbot works hard to keep Kubernetes cluster in a good shape](./docs/banner.png)

## Ugrading from v0.3.X to v1.1.X

* **IMPORTANT** - Before you upgrade, please note that multi-tenancy support has changed in versions after v0.3.X
* We no longer support running multiple instances of the provider in the same management cluster. Typically this was done to enable multiple credentials for managing devices in more than one project.
* If you currently have a management cluster with multiple instances of the provider, it's recommended you use clusterctl move to migrate them to another cluster before upgrading.
* [See more information about `clusterctl move` here](https://cluster-api.sigs.k8s.io/clusterctl/commands/move.html)

* Upgrade your clusterctl to version 1.1.3 or later.
* Backup your clusterapi objects from your management cluster by using the `clusterctl backup` comamnd.

```bash
clusterctl backup --directory /path/to/backup/directory/
```

* More details are available [here](https://cluster-api.sigs.k8s.io/clusterctl/commands/upgrade.html).
* The next step is to run `clusterctl upgrade plan`, and you should see something like this:

```bash
Latest release available for the v1beta1 API Version of Cluster API (contract):

NAME NAMESPACE TYPE CURRENT VERSION NEXT VERSION
bootstrap-kubeadm capi-kubeadm-bootstrap-system BootstrapProvider v0.3.25 v1.1.2
control-plane-kubeadm capi-kubeadm-control-plane-system ControlPlaneProvider v0.3.25 v1.1.2
cluster-api capi-system CoreProvider v0.3.25 v1.1.2
infrastructure-packet cluster-api-provider-packet-system InfrastructureProvider v0.3.11 v0.5.0

You can now apply the upgrade by executing the following command:

clusterctl upgrade apply --contract v1beta1
```

* Go ahead and run `clusterctl upgrade apply --contract v1beta1`
* After this, if you'd like to co ntinue and upgrade kubernetes, it's a normal upgrade flow where you upgrade the control plane by editing the machinetemplates and kubeadmcontrolplane and the workers by editing the machinesets and machinedeployments. Full details [here](https://cluster-api.sigs.k8s.io/tasks/upgrading-clusters.html). Below is a very basic example upgrade of a small cluster:

```bash
kubectl get PacketMachineTemplate example-control-plane -o yaml > example-control-plane.yaml
# Using a text editor, edit the spec.version field to the new kubernetes version
kubectl apply -f example-control-plane.yaml
kubectl get machineDeployment example-worker-a -o yaml > example-worker-a.yaml
# Using a text editor, edit the spec.template.spec.version to the new kubernetes version
kubectl apply -f example-worker-a.yaml
```

## Using

The following section describes how to use the cluster-api provider for packet (CAPP) as a regular user.
Expand Down
15 changes: 15 additions & 0 deletions docs/experiences/cni.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# CNI Notes

## Calico

### Install

When using the CAPI quickstart, follow the [Calico install instructions from Tigera](https://projectcalico.docs.tigera.io/getting-started/kubernetes/quickstart).

## Flannel

### Install

Follow the instructions at <https://github.com/flannel-io/flannel#deploying-flannel-manually> (ignoring the instruction to create a `flanneld` binary on each node).

When declaring your cluster, set the `POD_CIDR` to `10.244.0.0/16` which is the default `Network` (`net-conf.json`) for Flannel, or update the Flannel manifest to match the desired POD CIDR.

0 comments on commit f859b99

Please sign in to comment.