kubevela.github.io/docs/quick-start.md

83 lines
3.3 KiB
Markdown

---
title: Deploy First Application
---
> Before starting, please confirm that you've installed KubeVela Core and VelaUX in the control plane cluster based on [Installation](./install.mdx)
>
> If you want to use KubeVela CLI for application delivery, please check [Deliver First Application](./end-user/quick-start-cli) in the Vela CLI manual.
Welcome to KubeVela! In this section, we show you how to deliver your first app via VelaUX.
Follow these steps:
1. Prepare a Docker image. we use [crccheck/hello-world](https://hub.docker.com/r/crccheck/hello-world) for this time. Double-check if you're able to download it properly.
2. Create the first `Application` of `webservice` which is the common way to deploy stateless service.
3. Check out the status of the Application's instance.
You'll get to know:
- Get familiar with core concepts as [Application](./getting-started/core-concept#application), [Environment](getting-started/core-concept#environment) and [Target](getting-started/core-concept#target)
- Finished an application delivery by operating VelaUX
## Get password and login
After install VelaUX, you need to log in. Default username is "admin" and you can get the password using command below
```shell
vela logs -n vela-system --name apiserver addon-velaux | grep "initialized admin username"
```
![](./resources/login.png)
## Choosing deployment type and Environment
After login, the first page you enter is for managing the app:
![](./resources/dashboard.png)
Then click the button of `New Application` on the upper-right, type in these things:
1. Name and other basic Infos.
<!-- 2. Choose the Project. We've created a default Project for you to use or you can click `New` to create your own. -->
2. Choose the deployment type. In this case, we use `webservice` to deploy Stateless Application.
3. Choose your environment. We select the `Default` Environment based on the `Default` Target.
![](./resources/new-first-vela-app.jpg)
## Setting up properties
Next step, we see the page of properties. Configure following:
- Image address `crccheck/hello-world`
> Other properties can be left blank for this case
![](./resources/port-first-vela-app.png)
Confirmed. Notice that this application is only created but not deployed yet. VelaUX defaultly generates [Workflow](./getting-started/core-concept#workflow) and replicas of [Trait](./getting-started/core-concept#trait).
![](./resources/created-first-vela-app.jpg)
## Executing Workflow to deploy
Click the deploy button on the upper-right. When the workflow is finished, you'll get to see the list of status lying within.
![](./resources/succeed-first-vela-app.jpg)
In the process of deploying, you can click `Check the details` to view the status of the application:
![](./resources/status-first-vela-app.jpg)
## Deleting Application
If you want to delete the application when it's no longer used, simply:
1. Enter the page of environment, click `Recycle` to reclaim the resources that this environment used.
2. Go back to the list of applications and click the drop-down menu to remove it.
That's it! You succeed at the first application delivery. Congratulation!
## Next Step
- View [Tutorials](./tutorials/webservice) to look on more of what you can achieve with KubeVela.
- View [How To guides](./how-to/dashboard/application/create-application) to check out more features.