Skip to main content

Application Components

🕓 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

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.

LanguageBuild ToolFramework
C#Nuget.NET Core
C#Nuget.NET
JavaGradleNone
JavaMavenMicronaut
JavaMavenSpring Boot
JavaMavenNone
JavaScriptNPMReact
JavaScriptNPMStorybook for React
PHPComposerNone
TypeScriptNPMStorybook 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.
  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.

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 ⚙️