In Devtron, an application represents your software project. You can create an application both by using the Chart Store (for Helm apps) and by creating it from scratch as a Custom Devtron Application. If you prefer to create a Helm application using the Chart Store, please refer to Charts. However, when you create a Devtron application is when you can configure the CI/CD pipeline, build and deploy your application, and perform other related tasks.
This document provides you step-by-step instructions on creating a new custom Devtron application.
To create a custom Devtron application, you need:
Admin access to create, edit, deploy, and delete permitted Devtron applications. For more information, refer to Devtron App Permissions.
Build and Deploy (CI/CD) integration set up in Devtron to automate the build and deployment process. For more information on the integration, please refer to Build and Deploy (CI/CD).
A project created in the Projects page (Global Configurations → Projects).
Follow the below instructions to create a new custom Devtron application:
Navigate to the Applications page in Devtron.
Click the Create button at the top-right corner of the screen.
Perform one of the following actions:
a. Click on the From Chart store option to create a Helm app from the Chart store. For more information on creating Helm apps, refer to Charts.
b. Click on the Job option to create or clone a job. For more information, refer to Jobs.
c. Click on the Custom app option to create a custom Devtron application. The Create Devtron Application page is then displayed. The Blank application option is selected by default. However, if you wish to clone an existing application, click on Clone application. For more information, refer to Clone Application.
Select your preferred project from the Project drop-down box. All the projects that you have created in the Projects page (Global Configurations → Projects) are displayed as available options in the Project drop-down box.
Enter your application name in the Application name text box. You can enter a minimum of 3 and a maximum of 30 alphanumeric characters in the Application name text box. The usage of special characters and spaces are restricted. However, you can use hyphens (-) for separation.
Enter the description for your application in the Description text box (optional step).
Expand the Add tags to application (optional step). To propagate tags to your application, refer to Propagate Tags to Your Application.
Click the Create Application button.
A new custom Devtron application is now created. The same is also displayed in the Devtron Apps tab in the Applications page.
Now that a new custom Devtron application has been created, the next step is to configure it. To configure a Devtron application, refer to Configure a Devtron Application.
You can propagate tags while creating a Devtron application. When you propagate tags to your application, the specified tags are automatically transferred from a high-level Kubernetes resource, such as your application, to the low-level Kubernetes resources, such as pods, services, etc., This way, tag propagation allows you to troubleshoot issues, query on related components, filter, group metrics and much more.
Follow the below instructions to propagate tag to your application:
Enter the key name in the KEY field and the corresponding value in the VALUE field in the Create Devtron Application page.
Click the + icon against KEY to add more tags, if required.
Click the Create Application button.
Click the symbol on the left side of the KEY column to propagate a tag. A dark color in the symbol represents that the tags are propagated.
Click the symbol again to remove the tags from propagation.
