Build and deploy your code | Getting Started | Northflank Application docs
v1

Getting Started /

Build and deploy your code

This walkthrough will take you through the steps to build and deploy your code in one simple service.

Combined services are a self-contained continuous integration and continuous delivery system.

It's as easy as choosing a branch from a Git repository to automatically build and deploy from.

Combined services cannot be added to a pipeline as they act as a self-contained pipeline. If you want to create a more complex workflow, the set up a pipeline walkthrough will take you through all the steps.

Create a combined service

All aspects of a combined service can be configured after creation - except the name.

  1. Click here , or choose service from the create new menu in the top right corner of the dashboard
  2. Select combined
  3. Basic information: select combined service and enter a name
  4. Repository: select the repository from the drop-down list and choose the branch you want to build from
  5. Build options: choose Dockerfile if you have a Dockerfile in your registry, or buildpack to automatically build your application. If your Dockerfile and/or build context are not root, specify the relative paths.
  6. Environment variables (optional): you can set runtime variables and build arguments, or add secret files in advanced
  7. Networking (optional): Northflank will automatically detect and add ports exposed in your Dockerfile, or add a public port for buildpacks. You can create a service with no ports. Networking will be covered in more detail later in this walkthrough.
  8. Resources: leave the resources as the default values for now, this walkthough will cover scaling later
  9. Advanced (optional): you can configure health checks, a Docker CMD override, and add a persistent volume
  10. Click create service
Creating a combined service in the Northflank application

Service dashboard

You will be taken to your new service's overview after creating it, you can find your service again by clicking on the services icon in the project menu on the left.

Your combined service will immediately start to build the latest commit to your branch.

Your combined service has CI/CD enabled by default and will automatically build and deploy the latest commits to your linked repository branch.

A combined service overview in the Northflank application

Combined service controls

The service header displays some useful details of the service at a glance:

  • Public DNS
  • Service region
  • Git repository
  • Repository branch
  • Currently deployed commit hash
  • Active containers and their status

You can manage your service using the