kubevela/docs/en/quick-start.md

title

title
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

$ kubectl apply -f https://raw.githubusercontent.com/oam-dev/kubevela/master/docs/examples/vela-app.yaml
application.core.oam.dev/first-vela-app created

Check the status until we see status is running and services are healthy:

$  kubectl get application first-vela-app -o yaml
apiVersion: core.oam.dev/v1beta1
kind: Application
...
status:
  ...
  services:
  - healthy: true
    name: express-server
    traits:
    - healthy: true
      message: 'Visiting URL: testsvc.example.com, IP: your ip address'
      type: ingress
  status: running

If your cluster has a working ingress, you can visit the service.

$ curl -H "Host:testsvc.example.com" http://<your ip address>/
<xmp>
Hello World


                                       ##         .
                                 ## ## ##        ==
                              ## ## ## ## ##    ===
                           /""""""""""""""""\___/ ===
                      ~~~ {~~ ~~~~ ~~~ ~~~~ ~~ ~ /  ===- ~~~
                           \______ o          _,/
                            \      \       _,'
                             `'--.._\..--''
</xmp>

Voila! You are all set to go.

What's Next

Here are some recommended next steps:

• Learn KubeVela starting from its core concepts
• Learn more details about Application and what it can do for you.
• Learn how to attach rollout plan to this application, or place it to multiple runtime clusters.
• Join #kubevela channel in CNCF Slack and/or Gitter

Welcome onboard and sail Vela!