Skip to main content

Config services

services gives you the options to configure the Kubernetes workloads for better deployment and development experiences. You can configure single or multiple workloads in a single configuration which depends on your application design.

For example:

applications:    name: K8s-app    ...    services:    - name: deployment-workload      serviceType: deployment        dependLabelSelector:          pods: []          jobs:            - dep-job        containers: ...    - name: statefulset-workload      serviceType: statefulset        dependLabelSelector:          pods: []          jobs:            - dep-job        containers: ...

How does it work?#

Each entry you configure under application[*].services will tell Nocalhost to search for the corresponding workload and configure it. If Nocalhost finds a workload to configure, it will apply the given configurations.

Workload Selection#

The following config options are needed to determine the workload to be configured:


Nocalhost uses the name as a unique identifier to match a corresponding Kubernetes workload. The name option expects a string that specifies a workload name to select a target workload.

services:  - name: foo-workload-01  ...  - name: foo-workload-02  ...


Kubernetes workload type, Nocalhost currently supports all Kubernetes workloads types.

services:    - name: deployment-workload        serviceType: deployment        ...


Nocalhost can control the startup sequence of multiple workloads within an application. This is especially useful if:

  • Workload is dependent on other workloads or services
Required Kubernetes 1.16.0+

This feature depends on Kubernetes admission webhooks, so please ensure that the minimum version of the Kubernetes is v1.16.0 or Above, and make sure to enable MutatingAdmissionWebhook and ValidatingAdmissionWebhook controllers.

required nocalhost-dep

You need to install nocalhost-dep for this configuration to take effect. Please refer to Nocalhost Dep for more details.

Example: Setting up start dependencies#

services:  - name: foo-app                   # string    | required | Name of workload    serviceType: deployment         # string    | required | The Kubernetes workloads type    dependLabelSelector:      pods:                         # string[]  | optional | Dependent Pods label selector        - A-Pod        - B-Pod      jobs:                         # string[]  | optional | Dependent Jobs label selector        - "name=foo-db"


  • Nocalhost will continuously monitor the status of the A-Pod, B-Pod and foo-db
  • Once these pods and job become available, Nocalhost will start the deployment foo-app


Whether your workload is a single component or several that work together, on Kubernetes you run it inside a set of pods. In Kubernetes, a Pod represents a set of running containers on your cluster.

Nocalhost give you the options to configure these containers before deploying and developing.

services:    - name: foo-workload      ...      containers:        - name: container-0            ...        - name: container-1            ...        - name: container-2            ...


Nocalhost use container name as unique identifier to determine the container to be configured. You can define more than one container with a workload in services[*].containers.

Example: Configure containers#

services:    - name: foo-workload      serviceType: deployment      ...      containers:        - name: product            install:                # struct  | optional | Installation parameters              env: []              envFrom:                envFile: []              portForward:                - 39080:9080            dev: ...                # struct  | optional | Development parameters        - name: supermarket            install:                env: []                envForm: ...                protForward:                    - 38080:9080            dev: ...


You can configure the installation of the container. Nocalhost supports the following installation configuration for the container.

Inject Environment Variable to Containers#

Nocalhost supports injecting the preset environment variables to the container when deploying the workload. You can inject these variables by input the values or import the file.

nocalhost-dep Needed

You need to install nocalhost-dep for this configuration to take effect. Please refer to Nocalhost Dep for more details.

Example: Inject environment variable#

containers[*].install.env # optional

containers:  - name: container-01    ...    install:      env:         - name: DEBUG          value: ${DEBUG:-true}        - name: DOMAIN          value: ""

containers[*].install.envFrom # optional

containers:  - name: container-01    ...    install:      envFrom:         envFile:           - path: dev.env          - path: dev.env


  • These variables will be injected into container when deploying
  • These variables will take effect after the deployment occurs
Duplicate Configs

If both env and envFrom configure together, Nocalhost will merge the configurations, and the duplicate parts are subject to env configs.

Setting up Port-Forwarding#


Port-forwarding allows you to access your container on localhost:[PORT] by forwarding the network traffic from a localhost port to a specified port of a container.

When container has deployed, Nocalhost starts port-forwarding as configured in the install.port section.


containers:  - name: container-01    ...    install:      portForward:         - 9883:3306       # string[]  |  optional  | Ports to be forwarded to local when container has been deployed        - 9884:3307        
  • Using Local Port : Remote Port format
  • Can setup multi port-forward


You can configure the container before entering development. Learn more about how to configure development mode