Quick Start

Welcome to KubeVela! In this guide, we’ll walk you through how to install KubeVela, and deploy your first simple application.

Step 1: Install

Make sure you have finished and verified the installation following this guide.

Step 2: Deploy Your First Application

  1. $ vela up -f https://raw.githubusercontent.com/oam-dev/kubevela/master/docs/examples/vela.yaml
  2. Parsing vela.yaml ...
  3. Loading templates ...
  5. Rendering configs for service (testsvc)...
  6. Writing deploy config to (.vela/deploy.yaml)
  8. Applying deploy configs ...
  9. Checking if app has been deployed...
  10. App has not been deployed, creating a new deployment...
  11. ✅ App has been deployed 🚀🚀🚀
  12.     Port forward: vela port-forward testapp
  13.              SSH: vela exec testapp
  14.          Logging: vela logs testapp
  15.       App status: vela status testapp
  16.   Service status: vela status testapp --svc testsvc

Check the status until we see Routes are ready:

  1. $ vela status testapp
  2. About:
  4.   Name:       testapp
  5.   Namespace:  default
  6.   Created at: ...
  7.   Updated at: ...
  9. Services:
  11.   - Name: testsvc
  12.     Type: webservice
  13.     HEALTHY Ready: 1/1
  14.     Last Deployment:
  15.       Created at: ...
  16.       Updated at: ...
  17.     Routes:
  18.       - route:  Visiting URL: http://testsvc.example.com  IP: localhost

In kind cluster setup, you can visit the service via localhost. In other setups, replace localhost with ingress address accordingly.

  1. $ curl -H "Host:testsvc.example.com" http://localhost/
  2. <xmp>
  3. Hello World
  6.                                        ##         .
  7.                                  ## ## ##        ==
  8.                               ## ## ## ## ##    ===
  9.                            /""""""""""""""""\___/ ===
  10.                       ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
  11.                            \______ o          _,/
  12.                             \      \       _,'
  13.                              `'--.._\..--''
  14. </xmp>

Voila! You are all set to go.

What’s Next

Congratulations! You have just deployed an app using KubeVela. Here are some recommended next steps:

Welcome onboard and sail Vela!