New Application Component

🕓 10 minutes

What you'll learn

• How to create a new Application Component that will contain the source code for a specific application logic.

What is a CodeNOW Application Component?

• Components in the Microservice architecture encapsulate a separate application logic, for example user details, billing, shipping and others.
• Application Components contain the source code for the given Application in separate Git repositories.
• Components have a separate versioning scheme (Each Component is versioned by its Builds).

note

An application in the microservices architecture is described by the application components and their orchestration.

Prerequisites

• An existing Application, see Create a New Application.

Supported technology stacks

note

If you want to use external Docker images, change how an Application is deployed with Helm Charts or your desired tech stack just isn't listed below, see Using custom cluster configuration and Docker images in CodeNOW.

Language	Build Tool	Framework
C#	Nuget	.NET Core
C#	Nuget	.NET
Java	Gradle	None
Java	Maven	Micronaut
Java	Maven	Spring Boot
Java	Maven	None
JavaScript	NPM	React
JavaScript	NPM	Storybook for React
PHP	Composer	None
TypeScript	NPM	Storybook for Angular

Create a new Component

1. Go to the Application Detail of the Application you want to create a Component for and click on Choose Action -> Create New Component (or Create Component under Components section).
2. Choose a name for the Application Component, optionally add a description.
   • Technical name is an identificator that will be used internally by CodeNOW. It is automatically truncated to 30 characters (because of Kubernetes labels). You can change the technical name yourself if you want to.
3. If you want to import an existing git repository instead of creating a new one, see Import an existing git repository.
4. Choose a supported technology stack (Language|Build Tool|Framework) that you want to use in the Component.
5. Java and PHP only: edit the package name in Starter Configuration.
6. If you want to connect a Managed Service (eg. a database, messaging service or authentication service) to your Component, click Add New Connection.
   • For more information, see Connect Service to Component.
7. Click Create Component.
8. Set up your Local Environment by doing the following:
   1. Make sure you have SSH set up.
   2. Clone your repository by running the given command. Click on Next.
   3. Follow the instructions in order to set up your local environment correctly. Instructions may vary depending on the stack you chose.

Click on Create New Component

Name your Component

Choose your stack

Edit package name if you've chosen Java or PHP

Optionally connect a Managed Service to your Component

Click Confirm

Clone your repository

Set up local environment

1 / 8

Import an existing git repository

info

CodeNOW currently supports importing repositories from GitHub.

While creating a new Component, do the following:

1. Click on Existing git repository under Git settings.

2. If this is your first time importing a repository from GitHub.

   1. Click on Authorize GitHub.
   2. Log in to your GitHub account.
   3. Choose which repositories will be accessed by CodeNOW.
   note

   All repositories to which CodeNOW already has access and on which your currently authorised acccount is a Collaborator will be automatically available to import.

3. Choose the repository you want to import.

   • you can edit your CodeNOW preferences in GitHub by clicking ⚙️

Select Authorize GitHub

Select repositories that will be authorised

Select repository that will be imported

1 / 3