A popular way to launch Kubernetes clusters is the command line tool known as kops.

https://github.com/kubernetes/kops

With kops, you can launch a cluster, store the configuration that was used to do so in s3, and easily make updates to the configuration while saving versions of your changes. Currently kops supports launching clusters in AWS, GCE (beta), and VMWare (alpha).

Getting Started

To avoid re-writing already excellent documentation, the first step is to head over to the kops getting started guide to get your cluster launched. This should take you about 25-35 minutes if you're comfortable in the dashboards of these providers.

AWS: https://github.com/kubernetes/kops/blob/master/docs/aws.md
GCE: https://github.com/kubernetes/kops/blob/master/docs/tutorial/gce.md

Once your cluster is launched, you should have 3 nodes running on the cloud provider you picked. You'll also have a handful of certificates and keys that were created for you, and some new entries in your local .kube/config. Once you've verified that kubectl is working as expected and you can run: 

kubectl get nodes 

and see that your nodes are ready, it's time to move on to the next step and get your cluster attached to Containership Cloud. 

Attaching your cluster

Make sure you have signed up and logged in to your Containership Cloud account.

Step 1. Click on the "Create" button and choose "Cluster"

Step 2. Choose "Attach Cluster"

Step 3. Give your cluster a name and an environment

Step 4. Grab your server address from your kubeconfig

`gold-macbook:~ phil$ grep server .kube/config
    server: https://api-philtestingkops-k8s-l-2rdorm-1734087341.us-east-2.elb.amazonaws.com
gold-macbook:~ phil$`

Step 4. Input your server address and click continue

Step 5. Grab your CA cert from your kubeconfig

We allow for both base64 encoded and base64 decoded certificates to be entered during this step.
To see your certificate, open the file .kube/config in your home directory and look for the line that specifies certificate-authority-data  under the clusters section of the file.

Mine looks like the following:
LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMwekNDQWJ1Z0F3SUJBZ0lNRlFxejNmN0JCSUR3amtock1BMEdDU3FHU0liM0RRRUJDd1VBTUJVeEV6QVIKQmdOVkJBTVRDbXQxWW1WeWJtVjBaWE13SGhjTk1UZ3dNVEUxTWpBME5qTXdXaGNOTWpnd01URTFNakEwTmpNdwpXakFWTVJNd0VRWURWUVFERXdwcmRXSmxjbTVsZEdWek1JSUJJakFOQmdrcWhraUc5dzBCQVFFRkFBT0NBUThBCk1JSUJDZ0tDQVFFQXR4VDUxT0F2MGMvK1FXbEVlbFhRMFljd0lqL2hQMnZzRGVlRW5LdHFpQVkxeHhuSkRnblkKUDBFd0RhclRId0RlNzY4c0plZlNZaUViUURZWE5mc0krQ1V5dll1cDkyWDN3WXRqRDl2ZVB6bFlTYlI2NENpaAoxcUtGWk5UNllSWUNYRHBOZm9PMDR5aUk2bDJNQmxrN0kwL2lneFNKZXh5Q3VXRDREMkhha3h2VGpRZzE5d0VvClBHVVRRYnVmcUlyMWdEenAyd01YakFQY241S3hwdTNFeWhLRTNnR29qcHhKbi9pVlFVM24wVlVtL3VLck13MkcKR3ZiY3BvZTI5NU1YdkRmdjJlcTZqL0hFOEZXTHY5clJhOUdhR0dEUjRwL0d6KzJZU0VsVXo1aW53SnlFVEQyQgpKTnRwcnhVRVFLRVFPVysvWmpmaFBuTkJDTitNU08rRnFRSURBUUFCb3lNd0lUQU9CZ05WSFE4QkFmOEVCQU1DCkFRWXdEd1lEVlIwVEFRSC9CQVV3QXdFQi96QU5CZ2txaGtpRzl3MEJBUXNGQUFPQ0FRRUFsZ0JhWVZ2WnVrS3cKencrM2RXQjRCakFVQ0NkSTJkUnhwTzJGMmVGcitWeXJPU1RnSGV1OTBnTGJ5WS9UbzI4dDNKWjR4bW1mdzA0VQoxV1MxdlQyWmQzVFo5c2txd1hFZUgyMktzZlpFZ2xPWi9KSWxvS2FqT0svSWhvSEFUemZPUTB6VElTeGpJajU1CjIzRmNWYnlHanBSSXEwYUx2TTQ5TGI0VnkxMERZZTVsWVRBcVRlY3V3QlhybkNLZkx0QUFxenFWM3I3SElXOWoKdnVmYjArQVlMZm9VTjVicjhmMWE4Yy9IS0huOEJZMHlmbjhPVUxyZHR1UGk4eUVLTTQvdFNDb2t1Q3RIQ0k1Vwp6dVNVTEt0N1BJOEtab1p0WFBCM2dnUnZXczJzWVBiZFpzUC9TczFXUDZpbjFQRklsR3ppOUNsaENuaitIbWdiCjlRSjcvZ05mUkE9PQotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg== 

Step 6. Add your CA cert and click continue

Step 7. Choose your cluster authentication method

We will be using the "Client Certificate" method of authenticating with the cluster when using the default kops configuration.

Step 8. Grab your client cert and keys from your kubeconfig

Mine look like the following and can be found under the users  section of the configuration.
client-certificate-data: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUMrekNDQWVPZ0F3SUJBZ0lNRlFxejNtTkhHa2hhWlJlSk1BMEdDU3FHU0liM0RRRUJDd1VBTUJVeEV6QVIKQmdOVkJBTVRDbXQxWW1WeWJtVjBaWE13SGhjTk1UZ3dNVEUxTWpBME5qTXlXaGNOTWpnd01URTFNakEwTmpNeQpXakFyTVJjd0ZRWURWUVFLRXc1emVYTjBaVzA2YldGemRHVnljekVRTUE0R0ExVUVBeE1IYTNWaVpXTm1aekNDCkFTSXdEUVlKS29aSWh2Y05BUUVCQlFBRGdnRVBBRENDQVFvQ2dnRUJBTmZ6RERxWFBNZXZOQVBBQmk5dkdPTEQKaWt4Qm1hZXg4VmdXT0k1OFRoR1RPRGo5c2FUOEJvMTV5QmQrT0I1VHlHbTE2eStOYVBnSEsvTXB0ZVpRd25QUwpMRFN0SWg5UUpCQldobmh2QnpEYk0vWUlncXFqMW0rSEdIc3RxSVh2MFdma0sranBHRUUvUFl2VndvWGU5RHFvClpMNHBXRTZxYjE2RWpnZEgwNlU4UUViRDdMYk5DOTBURldGeGJtcHE4dm1yK2xIY2RqaGp1VlNzbHBmL0lISEEKM0pZTmNxZkFIQWpSVjY3WSs2RmhmMTBnNWVIRHhJZUxBVUdjclZyQkp5dWIraklsZVg1MVF0UFZJd0p1bU5BSgp4Tm1BWG5QeGhvYnFoQVFabHpVd245cXFrbkxKVWZianR5eVRxWTlnOXhQWVRvRkJpaURUK1RUdGZQdHNDSTBDCkF3RUFBYU0xTURNd0RnWURWUjBQQVFIL0JBUURBZ2VBTUJNR0ExVWRKUVFNTUFvR0NDc0dBUVVGQndNQ01Bd0cKQTFVZEV3RUIvd1FDTUFBd0RRWUpLb1pJaHZjTkFRRUxCUUFEZ2dFQkFBMTFGd1UxS0lNVEJJL0swVGNoZkg1ZAp6SFNVd0RJbXZ5MDYvWkhhRnB0NTVyM2oyUlh0MDBrRFdNdkx6c0dPSTlCanJPRkZDVUgxSTM4K3hhZ3dMc21KCjhybnNsYVA0TXZRTk9vZmhKSDRBakJ4NCtJVE9oSDkvMmdFbVZxc3pSMTZjNE5jU1J1MUI3TGI2MStBbytkWVoKbFhxTlU5QUJsdlBKZmx2RVpIdUVsNTJ6cFpTZ2lEUFR4UFpwekZDY2phdlpIM25LZ09GNlg1TFZ4NWZWU3NJVApBbnR6OFF3NHljV1FaUDZYc1c2eFZSMFZFeWdoazM4bE5QUFFIVUFqZmliMW90aitKMEFsUGJMeEljUTFmR0ZxCkJPS1kvaVJuWkwyVkZkZDBzamoySVJJNDlYY1NWM1JkclBBTSttTkNLUmhrSVVKV2I4UE81UkwvVzhsNDh4cz0KLS0tLS1FTkQgQ0VSVElGSUNBVEUtLS0tLQo=

client-key-data: LS0tLS1CRUdJTiBSU0EgUFJJVkFURSBLRVktLS0tLQpNSUlFcEFJQkFBS0NBUUVBMS9NTU9wYzh4NjgwQThBR0wyOFk0c09LVEVHWnA3SHhXQlk0am54T0VaTTRPUDJ4CnBQd0dqWG5JRjM0NEhsUElhYlhyTDQxbytBY3I4eW0xNWxEQ2M5SXNOSzBpSDFBa0VGYUdlRzhITU5zejlnaUMKcXFQV2I0Y1lleTJvaGUvUlorUXI2T2tZUVQ4OWk5WENoZDcwT3Foa3ZpbFlUcXB2WG9TT0IwZlRwVHhBUnNQcwp0czBMM1JNVllYRnVhbXJ5K2F2NlVkeDJPR081Vkt5V2wvOGdjY0RjbGcxeXA4QWNDTkZYcnRqN29XRi9YU0RsCjRjUEVoNHNCUVp5dFdzRW5LNXY2TWlWNWZuVkMwOVVqQW02WTBBbkUyWUJlYy9HR2h1cUVCQm1YTlRDZjJxcVMKY3NsUjl1TzNMSk9wajJEM0U5aE9nVUdLSU5QNU5PMTgrMndJalFJREFRQUJBb0lCQVFDMzAyR1pqcHhpcnpYcgo2MDVZbW8zb211UGpQZ1I2eC9MV05UUTN0b0VPWFBBRE01SkJDM2pZZmM1aWtVTmNMWjN3dnJkUloyTHZuOHM5CjEwZk1vdnFrZFVqRUhvMXBjbU1BdFdjS3Boak04Z3d0WjlrelFQeU5POGNQTkRLOHNRVGxGMHA1bmRMVDErMmcKVjNxYlVzczhFNVNPZTh0OFM0RTZTRVJPMWtuSDRRMmpIWGMySkljR0JBQlVuUHZoYnRSSEVlZGNrR2paU1FOZQpCOU54am53cDhCSW5OR0d2bDEyZGw5aysrbnhNUHZsam1wVGJoc1RvdkNSekg0eUpnNVBYNEJzMWcrbEZEVWxsCnBOMFZPQW54ZklHUG82RmxqbXhRdGJsZkxmSmYyY25jRmFUaGRzNmRmRlVzMWpubmpFclNibThjNGdjK0U4S1IKZ3FIL1Z0WFJBb0dCQVBMaEtDd0Z4UndMc0oxMHByVy9BSGlNN1hCbEI0L1hFMHB4RmxScnpWa2RKd0lEQ0VaSwpjUDJCdEErOGlvaUY2S0h6SWRSRks1YTZTOXBrVjM2bEZyQStZT0krbFZUVTQrU2pzNGV3ZHdMbUJ5L3ZVV0tDCitZdFk1Ky9yWkhKZTJmNWprdkFYRFp2NUNpSWhWRDhHWVVka2ZNYUF4Ync5aW9WSjIrbDNZeFUvQW9HQkFPT2QKZDZmYjFpYngvT3F0eW5HYkF5WWhCT0lTNXNESDZVWWdZaEZnejFtalNlWHJ6NkNJNFNYUGRyL25NK2xOWWgyRQpWaElCZnFVVGZMcGpjbC9nMnVxREM5VkhJMm1lVXA1YzJqOWVrbThWK2xnMnBWVnZrTGw5alZwR0F1aGlwUkt3Cm1maFdrNjJIVEdzaU5udWlVYUdoZWFuVmFzVWh4Y201RlBsbGZQTXpBb0dBTUZ6NVhOckJSelprc3RYWnBITW0KS3RzVkpMNVpaU0VVckV3Y2dDNy9NdkdGSlBkcG5HV1NYa2lIakdLa3kwNnU1aUM5NmNEa1R4MUZvWFU5bnZCTQp0a2VWanplYkVNdGJuZG1qRkMvbFl1UmZKZ0pubUZBd1ZMa2RaajdmUDQ3M3BabzZWaWloQXgveURwM0lZc3hvCmJvanA5N1VJcXRVdVVpQkU5QlpiMm8wQ2dZQjR3SUZLUEFaUWd2QjZUOWltakdZUFJGVWkyb1F3b2QzUHBqNWcKbWN0bThvbXh3SGhWNGtnUGx4Q1luaitiOWNHbmh4MWlVQWl2NnJhdzZ6RXlURWZYUWM1MVIxZ3lJQndVaDQ0QgpNRnJmTS9tcjh0R2prWnhseTRYQjdvSjhabGpNb1lRTmkyQ3RIcW9iNi9xYmZIRnlIZ2c5WVV0VGFhZFViU3dECll5UDJvUUtCZ1FDYTFKK1A0ZmpvUUFzRksxZ29STGw2M29MUDFRdGNNc3l2UXQrYUdWR1pSS1V6VWZ3NlpSZisKVXo3R0hyMk1Ca2N0Tk93UGx1aGdGcWs2SlBld1g2VmxCYUUzTEFuOVhESEJsTGZsZCtZc3RURXNZd05rQ3NKdQpKS0FIeC96WkNuc0gxYmtuSVk4akhTd3FjVEg3NGpGckZYdEphdUJCaXViQ2FEZ0l1MTVDOEE9PQotLS0tLUVORCBSU0EgUFJJVkFURSBLRVktLS0tLQo= 

Step 9. Add your client cert and key and click continue

Step 10. Select optional Containership plugins

Step 10. Your cluster is now successfully attached! Breathe a sigh of relief at how much easier managing your Kubernetes cluster will be now.

Did this answer your question?