📖 Add MachineDeployment example

Signed-off-by: Vince Prignano <[email protected]>

Author: vincepri

docs/book/src/images/management-cluster.svg

@@ -5,7 +5,7 @@ In this tutorial we'll cover the basics of how to use Cluster API to create one
 ## Prerequisites
 
 - Install and setup [kubectl] in your local environment.
-- A Kubernetes cluster to be used as [management cluster](../reference/glossary.md#management-cluster), for the purpose of this quick start, we suggest you to use [kind].
+- A Kubernetes cluster to be used as [management cluster](../reference/glossary.md#management-cluster), for the purpose of this quick start we suggest you to use [kind] as a non production-ready solution.
     ```bash
     kind create cluster --name=clusterapi
     export KUBECONFIG="$(kind get kubeconfig-path --name="clusterapi")"
@@ -48,7 +48,7 @@ Check the [AWS provider releases](https://github.com/kubernetes-sigs/cluster-api
 For more information about prerequisites, credentials management, and or permissions for AWS, visit the [getting started guide](https://github.com/kubernetes-sigs/cluster-api-provider-aws/blob/master/docs/getting-started.md).
 
 ```bash
-kubectl create -f https://github.com/kubernetes-sigs/cluster-api-provider-aws/releases/download/v0.4.0/infrastructure-components.yaml
+kubectl create -f https://github.com/kubernetes-sigs/cluster-api-provider-aws/releases/download/v0.4.1/infrastructure-components.yaml
 ```
 
 {{#/tab }}
@@ -80,7 +80,6 @@ For the purpose of this tutorial, we'll name our cluster `capi-quickstart`.
 {{#tab AWS}}
 
 ```yaml
----
 apiVersion: cluster.x-k8s.io/v1alpha2
 kind: Cluster
 metadata:
@@ -114,7 +113,6 @@ These examples include environment variables that you should substitute before c
 </aside>
 
 ```yaml
----
 apiVersion: cluster.x-k8s.io/v1alpha2
 kind: Cluster
 metadata:
@@ -159,7 +157,6 @@ Now that we've created the cluster object, we can create a control plane Machine
 {{#tab AWS}}
 
 ```yaml
----
 apiVersion: cluster.x-k8s.io/v1alpha2
 kind: Machine
 metadata:
@@ -218,7 +215,6 @@ These examples include environment variables that you should substitute before c
 </aside>
 
 ```yaml
----
 apiVersion: cluster.x-k8s.io/v1alpha2
 kind: Machine
 metadata:
@@ -307,6 +303,171 @@ spec:
 {{#/tab }}
 {{#/tabs }}
 
+After the controlplane is up and running, we should apply the addons to install Calico.
+
+{{#tabs name:"tab-usage-addons" tabs:"AWS,vSphere"}}
+{{#tab AWS}}
+
+```bash
+kubectl apply -f https://raw.githubusercontent.com/kubernetes-sigs/cluster-api-provider-aws/v0.4.1/examples/addons.yaml
+```
+{{#/tab }}
+{{#tab vSphere}}
+
+```bash
+kubectl apply -f https://raw.githubusercontent.com/kubernetes-sigs/cluster-api-provider-vsphere/v0.5.0/examples/addons.yaml
+```
+
+{{#/tab }}
+{{#/tabs }}
+
+At this point, our control plane should be up and in `Ready` state, check the status using `kubectl get nodes`.
+
+Finishing up, we'll create a single node _MachineDeployment_.
+
+{{#tabs name:"tab-usage-machinedeployment" tabs:"AWS,vSphere"}}
+{{#tab AWS}}
+
+```yaml
+apiVersion: cluster.x-k8s.io/v1alpha2
+kind: MachineDeployment
+metadata:
+  name: capi-quickstart-md-0
+  labels:
+    cluster.x-k8s.io/cluster-name: capi-quickstart
+    nodepool: nodepool-0
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      cluster.x-k8s.io/cluster-name: capi-quickstart
+      nodepool: nodepool-0
+  template:
+    metadata:
+      labels:
+        cluster.x-k8s.io/cluster-name: capi-quickstart
+        nodepool: nodepool-0
+    spec:
+      version: v1.15.3
+      bootstrap:
+        configRef:
+          name: capi-quickstart-md-0
+          apiVersion: bootstrap.cluster.x-k8s.io/v1alpha2
+          kind: KubeadmConfigTemplate
+      infrastructureRef:
+        name: capi-quickstart-md-0
+        apiVersion: infrastructure.cluster.x-k8s.io/v1alpha2
+        kind: AWSMachineTemplate
+---
+apiVersion: infrastructure.cluster.x-k8s.io/v1alpha2
+kind: AWSMachineTemplate
+metadata:
+  name: capi-quickstart-md-0
+spec:
+  template:
+    spec:
+      instanceType: t3.large
+      iamInstanceProfile: "nodes.cluster-api-provider-aws.sigs.k8s.io" # This IAM profile is part of the pre-requisites.
+      sshKeyName: default # Change this value to a valid SSH Key Pair present in your AWS Account.
+---
+apiVersion: bootstrap.cluster.x-k8s.io/v1alpha2
+kind: KubeadmConfigTemplate
+metadata:
+  name: capi-quickstart-md-0
+spec:
+  template:
+    spec:
+      joinConfiguration:
+        nodeRegistration:
+          name: '{{ ds.meta_data.hostname }}'
+          kubeletExtraArgs:
+            cloud-provider: aws
+```
+
+{{#/tab }}
+{{#tab vSphere}}
+
+<aside class="note warning">
+
+<h1>Action Required</h1>
+
+These examples include environment variables that you should substitute before creating the resources.
+
+</aside>
+
+```yaml
+apiVersion: cluster.x-k8s.io/v1alpha2
+kind: MachineDeployment
+metadata:
+  name: capi-quickstart-md-0
+  labels:
+    cluster.x-k8s.io/cluster-name: capi-quickstart
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      cluster.x-k8s.io/cluster-name: capi-quickstart
+  template:
+    metadata:
+      labels:
+        cluster.x-k8s.io/cluster-name: capi-quickstart
+    spec:
+      version: v1.15.3
+      bootstrap:
+        configRef:
+          apiVersion: bootstrap.cluster.x-k8s.io/v1alpha2
+          kind: KubeadmConfigTemplate
+          name: capi-quickstart-md-0
+      infrastructureRef:
+        apiVersion: infrastructure.cluster.x-k8s.io/v1alpha2
+        kind: VSphereMachineTemplate
+        name: capi-quickstart-md-0
+---
+apiVersion: infrastructure.cluster.x-k8s.io/v1alpha2
+kind: VSphereMachineTemplate
+metadata:
+  name: capi-quickstart-md-0
+spec:
+  template:
+    spec:
+      datacenter: "${VSPHERE_DATACENTER}"
+      network:
+        devices:
+        - networkName: "${VSPHERE_NETWORK}"
+          dhcp4: true
+          dhcp6: false
+      numCPUs: ${VSPHERE_NUM_CPUS}
+      memoryMiB: ${VSPHERE_MEM_MIB}
+      diskGiB: ${VSPHERE_DISK_GIB}
+      template: "${VSPHERE_TEMPLATE}"
+---
+apiVersion: bootstrap.cluster.x-k8s.io/v1alpha2
+kind: KubeadmConfigTemplate
+metadata:
+  name: capi-quickstart-md-0
+spec:
+  template:
+    spec:
+      joinConfiguration:
+        nodeRegistration:
+          name: "{{ ds.meta_data.hostname }}"
+          criSocket: "/var/run/containerd/containerd.sock"
+          kubeletExtraArgs:
+            cloud-provider: vsphere
+      users:
+      - name: capv
+        sudo: "ALL=(ALL) NOPASSWD:ALL"
+        sshAuthorizedKeys:
+        - "${SSH_AUTHORIZED_KEY}"
+      preKubeadmCommands:
+      - hostname "{{ ds.meta_data.hostname }}"
+      - echo "::1         ipv6-localhost ipv6-loopback" >/etc/hosts
+      - echo "127.0.0.1   localhost {{ ds.meta_data.hostname }}" >>/etc/hosts
+      - echo "{{ ds.meta_data.hostname }}" >/etc/hostname
+```
+
+{{#/tab }}
+{{#/tabs }}
 
 <!-- links -->
 [kubectl]: https://kubernetes.io/docs/tasks/tools/install-kubectl/