Get started in 5 minutes

Okteto Cloud gives you free access to a multi-tenant, self-service Kubernetes cluster to enable everyone on your team to develop applications in Kubernetes, the Cloud Native way.

This tutorial will have you creating an account in Okteto Cloud and deploying your own publicly available instance of the sample application in less than 5 minutes.

While you’re going through this guide, join the conversation in Slack! If you don’t already have a Kubernetes slack account, sign up here. We’d love to hear from you 😄 .

Step 1: Create your Okteto Cloud account

When you create an Okteto Cloud account, a Kubernetes service account, namespace, and credentials will be automatically created for you in the Okteto’s multi-tenant kubernetes cluster. These resources are configured automatically to include network policies, quotas, pod security policies, admission webhooks, roles, role bindings and limit ranges. This way, every developer has access to the Kubernetes cluster without interfering with other developer namespaces.

Step 2: Download your Kubernetes credentials

Download your Kubernetes credentials from Okteto Cloud and save them in a well known location. You should find the Credentials button at the top menu of the main screen:

Update the your KUBECONFIG environment variable so that it points to the credentials file you just downloaded:

MacOS/Linux:

1
$ export KUBECONFIG=$HOME/Downloads/okteto-kube.config:$KUBECONFIG

Windows:

1
> $Env:KUBECONFIG=("$Env:UserProfile\Downloads\okteto-kube.config;$Env:KUBECONFIG")

To see that the new configuration is working, enter this command:

1
$ kubectl get all

If you don’t have kubectl installed, follow this guide.

It’s this easy. Login with github, download your credentials, and you get full access to your Kubernetes namespace.

Step 3: Deploy the Sample Application

To get a local version of the sample application that you can then deploy to Okteto Cloud, execute the following commands in your local terminal:

1
2
$ git clone https://github.com/okteto/samples
$ cd samples/python

You now have a functioning git repository that contains a simple python application. In the manifest/ directory you also have the Kubernetes manifests needed to deploy the application into a Kubernetes cluster.

Deploy the application by executing the command below:

1
$ kubectl apply -f manifests
1
2
deployment.apps/vote created
service/vote created

Your application is now ready to be used. Open your browser and go the URL of the application. You can get the URL by logging into Okteto Cloud and clicking in the application’s endpoint.

Did you notice that you are accessing your application through an SSL endpoint? This is because Okteto Cloud will automatically create them for you when you deploy your application. Cool no 😎?

Congratulations, you just deployed your first application in Okteto Cloud 🚀. Go ahead and place a few votes on your favorite animal to try out the application.

Next steps

Now you know how easy it is to deploy a Kubernetes application in your Okteto Cloud namespace.

Now that you have an application running in Okteto Cloud head over to our guide on how to use Okteto Cloud to improve your development workflow by moving your development environment to Kubernetes.