PR5
  • Clone an Existing Application
Powered by GitBook
On this page
  • Introduction
  • Prerequisites
  • Clone an Existing Devtron Application
  • Next Steps
  • Extras
  • Propagate Tags to Your Application
  • What is Cloned and What is Not

Clone an Existing Application

Introduction

In Devtron, an application represents your software project. You can clone a Devtron application, but not a Helm application created using the Chart store. If you prefer to know more about creating Helm apps using Charts, please refer to Charts. However, when you clone a Devtron application, you can configure the CI/CD pipeline, build and deploy your application, and perform other related tasks just as you would when creating a new Devtron application.

This document provides you step-by-step instructions on cloning an existing Devtron application.


Prerequisites

To clone an existing Devtron application, you need:

  • Admin access to create, edit, deploy, and delete permitted Devtron applications. For more information, refer to Devtron App Permissions.

  • An existing Devtron application.

  • A project created in the Projects page (Global Configurations → Projects).


Clone an Existing Devtron Application

Follow the below instructions to clone an existing Devtron application:

  1. Navigate to the Applications page in Devtron.

  2. Click the Create button at the top-right corner of the page.

    Figure 1: Custom App
  3. Perform one of the following actions:

    a. Click on the From Chart store option to create a Helm application from the chart store. For more information, 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 clone an existing Devtron application. The Create Devtron Application page is then displayed. If you prefer to create a new Devtron application instead of cloning an existing one, please refer to Create an Application.

    Figure 2: Clone an Existing Devtron Application
  4. Click Clone application.

  5. 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.

  6. Enter the name of your cloned application 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.

  7. Enter the description for your cloned application in the Description text box (optional step).

  8. Expand the Add tags to application (optional step). To propagate tags to your application, refer to Propagate Tags to Your Application.

    Figure 3: Add Tags to Application
  9. Select your preferred existing Devtron application to clone from the Select an app to clone drop-down box. All Devtron applications created, irrespective of whether it is configured or not, are displayed as available options in the Select an app to clone drop-down box.

  10. Click the Create Application button.

    A cloned Devtron application is now created. The same is also displayed in the Devtron Apps tab in the Applications page.

    Figure 4: Application Configurations

Next Steps

Now that a cloned application has been created, the next step is to modify the Git repository, corresponding configurations and container registries of your cloned application. Please refer to What is Cloned and What is Not section in this document.

To know more about configuring a Devtron application, please refer to Configuring a Devtron Application.


Extras

Propagate Tags to Your 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:

  1. Enter the key name in the KEY field and the corresponding value in the VALUE field of the Create Devtron Application page.

  2. Click the + icon against KEY to add more tags, if required.

  3. Click the Create Application button.

What is Cloned and What is Not

Please refer to the table below to know what is cloned and what is not when you clone an existing, configured Devtron application:

What is Cloned
What is Not

GitHub repository configurations

No build is triggered

Container registry and repository

No deployment is triggered

Target platform for the build

No commit is deployed

Base configurations

Workflow editor

Trigger build & deploy pipeline configurations

Deployment strategy

Cluster

Namespace

Code source

When you clone an existing Devtron application that is not yet configured, the cloned application will also remain unconfigured.

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.