Core Concepts
Applications

Import an existing app

7min

When you deploy infrastructure with Microtica's templates, you have the possibility to create a new application in your Git repository or select an existing application if you already have one. 

1. Go to the Templates screen

On the templates page, you'll notice a section for importing your existing application. Selecting this button will redirect you to a page where you need to connect a Git account, choose a cluster where to deploy your app and Deploy.

Microtica template screen
Microtica template screen


2. Import Git Repository

As a first step, you need to connect a Git account (GitHub, Bitbucket, or GitLab). If you already have a Git account connected to Microtica, you can choose it from the list. Select the repository with your existing application code, click Save, and every Git push will be deployed automatically in Microtica.

Import an existing app template
Import an existing app template


3. Prepare your Git repository

When importing an existing project in Microtica, there are necessary files that need to be present in the repository, in order for the CI/CD pipelines to work correctly. These files are defined in the .microtica folder, whose content you can preview on our GitHub account.

Clicking the Add button will create a new .microtica folder in your app repository that contains (among other files) the microtica.yaml pipeline spec. The files contain some default configurations, so if you have anything specific for your application, you can update them.

Prepare Git repository - add files
Prepare Git repository - add files


Before continuing to the next step, we need to verify that these files are present in the repository. Clicking the Validate button will perform a check, and you can continue to choose where to deploy your application, once everything is correctly setup in your Git repo.

4. Configure template

In this step, you need to enter an application name. This name will be shown in the portal Environment -> Apps, so you're able to better differentiate your apps.

Here you can also add a port number. This is the port on which the application is listening for requests.

Configure template in Microtica
Configure template in Microtica


5. Select a cluster

The next step is choosing the Kubernetes cluster where your application will deploy. There are three options you can select to run your container app:

We recommend using Kubernetes on your own AWS account for production applications. 

After you're done continue to the next step - Deploying your applications.

6. Deploy the template to the cluster

Once you’re done with the cluster selection, you can go ahead and trigger a deployment of the environment by clicking on the Deploy button. 

Depending on the application, it takes approximately 4-5 minutes for your application to be deployed on the cloud. In the meantime, you can follow the detailed deployment logs by clicking the View Logs button.

Deployment logs - deploy template to the cluster
Deployment logs - deploy template to the cluster


7. Access application

When the deployment is finished, you will see a View Applications button, that leads you to the Apps tab inside the environment. Here you can see all your live applications that are deployed and currently running on the cloud.



View applications screen
View applications screen


For even more information, you can also look at the Deployments and Monitoring tabs, where you have the pipeline history, resource consumption metrics, and logs for your instances.

To learn more about how to scale your applications in Microtica, read the following article about Scaling Applications in Microtica.

Updated 19 Aug 2024
Doc contributor
Doc contributor
Did this page help you?