Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions docs/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,9 +41,9 @@
## Usage

* [Applications](user-guide/applications.md)
* [Create a new application](user-guide/create-application.md)
* [Clone an existing application](user-guide/cloning-application.md)
* [Deploy a sample application](user-guide/Deploy-sample-app/nodejs\_app.md)
* [Create a New Application](user-guide/create-application.md)
* [Clone an Existing Application](user-guide/cloning-application.md)
* [Deploy a Sample Application](user-guide/Deploy-sample-app/nodejs\_app.md)
* [App Configuration](user-guide/creating-application/README.md)
* [Git Repository](user-guide/creating-application/git-material.md)
* [Build Configuration](user-guide/creating-application/docker-build-configuration.md)
Expand Down
38 changes: 30 additions & 8 deletions docs/user-guide/create-application.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,41 @@
# Create a new application
# Create a New Application

* On the Devtron dashboard, select **Applications**.
* Select the **Create New** drop-down from the upper-right corner of the screen.
* On the upper-right corner of the screen, click **Create**.
* Select **Custom app** from the drop-down list.

![Create new application](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/create-app-1.jpg)
![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/create-app-1.jpg)

A new application can be created from one of the following methods:
A new application can be created from one of the following options:

* Custom App
* From Chart Store
* [From Chart Store](https://docs.devtron.ai/v/v0.6/usage/deploy-chart)


## Create Custom App

To create a new application from the custom app, select **Custom app**.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/create-application.jpg)

* In the **Create application** window, enter an **App Name** and select a **Project**.
* Select **Blank app** to create an application from scratch.
* Select **Create App**.
* Select either:<ul><li>**Create from scratch** to create an application from scratch, or<li>**Clone existing application** to clone an existing application.</ul></li>
* If you select **Create from scratch**, select the project from the drop-down list.<br>`Note`: You have to add [project under Global Configurations](https://docs.devtron.ai/global-configurations/projects). Only then, it will appear in the drop-down list here.
* If you select **Clone existing application**, select an app you want to clone from and the project from the drop-down list.<br>`Note`: You have to add [project under Global Configurations](https://docs.devtron.ai/global-configurations/projects). Only then, it will appear in the drop-down list here.</br>


## Tags

`Tags` are key-value pairs. You can add one or multiple tags in your application.

**Propagate Tags**
When tags are propagated, they are considered as labels to Kubernetes resources. Kubernetes offers integrated support for using these labels to query objects and perform bulk operations e.g., consolidated billing using labels. You can use these tags to filter/identify resources via CLI or in other Kubernetes tools.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/propagate-tags.jpg)

* Click `+ Add tag` to add a new tag.
* Click the symbol <img src="https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/donot-propagate.jpg" height="10"> on the left side of your tag to propagate a tag.<br>`Note`: Dark grey colour in symbol specifies that the tags are propagated.
* To remove the tags from propagation, click the symbol <img src="https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/propagate-dark.jpg" height="10"> again.
* Click `Save`.


![Create a custom app](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/create-app-2.jpg)
24 changes: 20 additions & 4 deletions docs/user-guide/creating-application/overview.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
# Overview

The `Overview` section contains the brief information of the application, any added tags, configured external links and deployment details of the particular application.
In this section, you can also [change project of your application](#change-project-of-your-application) and [manage tags](#manage-tags) if you added them while creating application.

The `Overview` section contains the brief information of the application, any added tags, configured external links and deployment details of the particular application.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/overview/overview-app-latest.jpg)
![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/overview-latest.jpg)


The following details are provided on the **Overview** page:
Expand All @@ -18,7 +18,7 @@ The following details are provided on the **Overview** page:

## Change Project of your Application

You can change the project of your application by selecting **Project** on the `Overview` section.
You can change the project of your application by clicking **Project** on the `Overview` section.

1. Click `Project`.
2. On the `Change project` dialog box, select the different project you want to change from the drop-down list.
Expand All @@ -32,3 +32,19 @@ Click **Save**. The application will be moved to the selected project.
* The current users will lose the access to the application.
* The users who already have an access to the selected project, will get an access to the application automatically.

## Manage Tags

`Tags` are key-value pairs. You can add one or multiple tags in your application. When tags are propagated, they are considered as labels to Kubernetes resources. Kubernetes offers integrated support for using these labels to query objects and perform bulk operations e.g., consolidated billing using labels. You can use these tags to filter/identify resources via CLI or in other Kubernetes tools.

`Manage tags` is the central place where you can create, edit, and delete tags. You can also propagate tags as labels to Kubernetes resources for the application.

![](https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/manage-tags-latest.jpg)

* Click `Edit tags`.
* On the `Manage tags` page, click `+ Add tag` to add a new tag.
* Click `X` to delete a tag.
* Click the symbol <img src="https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/donot-propagate.jpg" height="10"> on the left side of your tag to propagate a tag.<br>`Note`: Dark grey colour in symbol specifies that the tags are propagated.
* To remove the tags from propagation, click the symbol <img src="https://devtron-public-asset.s3.us-east-2.amazonaws.com/images/creating-application/propagate-dark.jpg" height="10"> again.
* Click `Save`.

The changes in the tags will be reflected in the `Tags` on the `Overview` section.