Okteto Cloud gives instant access to secure Kubernetes namespaces to enable developers to code, build, and run cloud-native applications entirely in the cloud.
This tutorial will show you how to develop and debug a Node.js sample application running in Okteto Cloud.
- Install the Okteto CLI (>= 1.12.13). Follow this guide if you haven't done it yet.
- Configure access to your Okteto Cloud Namespace using the Okteto CLI or using the Okteto Cloud UI.
Step 1: Deploy the Node.js Sample App
Get a local version of the Node.js Sample App by executing the following commands:
k8s.yml file contains the Kubernetes manifests of the Node.js Sample App.
Deploy a dev version of the application by executing:
Log into Okteto Cloud and click on the URL of the application:
Did you notice that you're accessing your application through an HTTPs endpoint? This is because Okteto Cloud will automatically create them for you when you deploy your application. Cool no 😎?
Step 2: Create your okteto manifest
To start developing on the Node.js Sample App you first need to create an okteto manifest. With the Node.js Sample App deployed, run the following command to create your okteto manifest:
okteto init command will scan the available deployments in your Kubernetes namespace and ask you to pick one.
hello-world deployment. It's the one we deployed on the previous step.
okteto init command creates the following
This file defines how to activate a development container for the Node.js Sample App:
name: the name of the Kubernetes deployment you want to put on development mode
command: the start command of the development container
sync: the folders that will be synchronized between your local machine and the development container
forward: a list of ports to forward from your development container
okteto init command creates a
.stignore file to indicate which files shouldn't be synchronized to your development container.
This is useful to avoid synchronizing binaries, build artifacts, git metadata, or dependencies like
Step 3: Activate your development container
Next, execute the following command to activate your development container:
Working in your development container is the same as working on your local machine. Start the application in hot-reload mode by running the following command:
Go back to the browser and reload the page to test that your application is running.
Step 4: Develop directly on Okteto Cloud
index.js file in your favorite local IDE and modify the response message on line 5 to be Hello world from the cluster!. Save your changes.
Okteto will synchronize your changes to your development container.
Take a look at the development container shell and notice how the changes are detected by
nodemon and automatically hot reloaded.
Go back to the browser and reload the page. Your code changes were instantly applied. No commit, build, or push required 😎!
Step 5: Debug directly on Okteto Cloud
Okteto enables you to debug your applications directly from your favorite IDE. Let's take a look at how that works in VS Code, one of the most popular IDEs for Node development. If you haven't done it yet, install the Node.js extension available from Visual Studio marketplace.
Cancel the execution of
nodemon index.js from the development container shell by pressing
ctrl + c.
Rerun your application in debug mode:
Open the Debug extension and run the Connect to okteto debug configuration (or press the F5 shortcut):
Add a breakpoint on
index.js, line 5. Go back to the browser and reload the page.
The execution will halt at your breakpoint. You can then inspect the request, the available variables, etc...
Your code is running in Okteto Cloud, but you can debug it from your local machine without any extra services or tools. Pretty cool no? 😉
Congratulations, you just developed your first application in Okteto Cloud 🚀.
Okteto lets you develop your applications directly on Kubernetes. This way you can:
- Eliminate integration issues by developing on a realistic environment
- Test your application end to end as fast as you type code
- No more CPU cycles wasted in your machine. Develop at the speed of the cloud!
Ready to develop your application on Okteto Cloud? Read our step by step tutorial on how to configure an Okteto Pipeline to deploy realistic environments for your application in just one click.