跳转至

快速入门

您可以配置适当的部署方法，通过 Nocalhost IDE 插件部署 K8s 应用程序。Nocalhost 支持以下类型部署应用:

  • RawManifest
  • Helm
  • Kustomize

部署配置结构

Dev Config is a part of Deploy Config. The simplest structure of Deploy Config is as follows:

1
2
3
4
application:
  name: ""
  manifestType: ""
  resourcePath: []

application includes the application name, application type and the resource array.

  • Application name will be displayed in Nocalhost plug-in. If the application type is Helm, it will be of the form Release.Name.
  • Applications are generally divided into three types, RawManifest, Helm and Kustomize. The deployment methods are different for different types, which is why it is necessary to distinguish types.
  • The last one is the resource path, which contains the paths of all the resources to be deployed.

Deployment configuration is usually declared through config.yaml

The name of Deploy Config is normally config.yaml, which is also the recommended name, but it is ok to use other names.

config.yaml has to be placed in the .nocalhost folder in git root directory.

1
2
3
4
├── .nocalhost
│   └── config.yaml
└── YourManifests
...

快速开始部署配置

We use bookinfo as an example here to introduce Deploy Config of Nocalhost.

RawManifest 最小化配置

The following is an actual Nocalhost Deploy Config, indicating that this is a RawManifest application, resourcePath contains all resource paths, when deployed, they will be applied to the api server through kubectl apply.

1
2
3
4
application:
  name: bookinfo
  manifestType: rawManifestGit
  resourcePath: ["manifest/templates"]

The directories are as follows, .nocalhost folder is created in the root directory, and config.yaml file is under the folder.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
├── .nocalhost
│   └── config.yaml
└── manifest
    └── templates
        ├── authors.yaml
        ├── bookinfo
        │   └── dep-job.yaml
        ├── detail.yaml
        ├── pre-install
        │   ├── print-num-job-01.yaml
        │   └── print-num-job-02.yaml
        ├── pre-install-cm.yaml
        ├── productpage
        │   └── productpage.yaml
        ├── ratings.yaml
        └── reviews.yaml

Use the following commands to experience.

1
git clone https://github.com/nocalhost/bookinfo && git checkout manifest/config/example

通过 Nocalhost 插件部署应用程序

You can right-click any namespace on Nocalhost plug-in, then click Deploy Application and select clone from git. Enter https://github.com/nocalhost/bookinfo to Git URL column and manifest/config/example to the branch column.

Nocalhost will deploy this RawManifest application after you click OK. Now, you can find bookinfo under namespace.

自定义 resourcePath 和 ignoredPath

resourcePath is an array used to specify the RawManifest files to be deployed. For example, for the above application, if you only want to apply *job*.yaml, you can change the configuration as follows.

1
2
3
4
application:
  name: bookinfo
  manifestType: rawManifestGit
  resourcePath: ["manifest/templates/pre-install"]

Moreover, Deploy Config also supports setting ignoredPath. For example, for the above application, if you only want to apply all manifest without *job*.yaml, you can change the configuration as follows.

1
2
3
4
5
application:
  name: bookinfo
  manifestType: rawManifestGit
  resourcePath: ["manifest/templates"]
  ignorePath: ["manifest/templates/pre-install"]

Kustomize 最小化配置

Just like RawManifest, config.yaml for Kustomize type is as follows. It indicates that this is a Kustomize application named bookinfo-kustomize and resourcePath is the directory corresponding to kubectl apply -k.

1
2
3
4
application:
  name: bookinfo-kustomize
  manifestType: kustomizeGit
  resourcePath: ["kustomize/base"]

该项目的目录结构如下，kustomize/base 对应到 kustomization.yaml 所在的相对目录：

Its directory structure is as follows, and kustomize/base corresponds to the directory containing kustomization.yaml.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
├── .nocalhost
│   └── config.yaml
└── kustomize
    └── base
        ├── authors.yaml
        ├── dep-job.yaml
        ├── detail.yaml
        ├── kustomization.yaml
        ├── pre-install
        │   ├── print-num-job-01.yaml
        │   └── print-num-job-02.yaml
        ├── pre-install-cm.yaml
        ├── productpage.yaml
        ├── ratings.yaml
        └── reviews.yaml

Use the following commands to experience.

1
git clone https://github.com/nocalhost/bookinfo && git checkout kustomize/config/example

Deploy this application by Nocalhost plug-in

You can follow the above instructions in Deploy the application by Nocalhost plug-in and enter kustomize/config/example to the branch column.

Helm 最小化配置

Like Kustomize, config.yaml for Helm type is as follows. It indicates that this is a Helm application named bookinfo-helm and its resourcePath is the directory corresponding to helm install .

1
2
3
4
application:
  name: bookinfo-helm
  manifestType: helmGit
  resourcePath: ["charts/bookinfo"]

Its directory structure is as follows, and charts/bookinfo corresponds to the directory containing Chart.yaml.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
├── .nocalhost
│   └── config.yaml
└── charts
    └── bookinfo
        ├── Chart.yaml
        ├── README.md
        ├── templates
        │   ├── _helpers.tpl
        │   ├── dep-job.yaml
        │   ├── microservice-authors.yaml
        │   ├── microservice-details.yaml
        │   ├── microservice-productpage.yaml
        │   ├── microservice-ratings.yaml
        │   └── microservice-reviews.yaml
        ├── values.yaml
        └── values_example.yaml

Use the following commands to experience.

1
git clone https://github.com/nocalhost/bookinfo && git checkout helm/config/example

Deploy this application by Nocalhost plug-in

You can follow the above instructions in Deploy the application by Nocalhost plug-in and enter helm/config/example to the branch column.

在“部署配置”中预配置 Dev 配置

Info

Please note that we assume that you have already known Dev Config before reading this section.

Dev Config can be embedded in Deploy Config. That brings a benefit that Nocalhost configuration would be contained in the application deployment process, which eliminates the repeated configuration work in the new environment. There is no conflict here, because it is equivalent to automatically associating Dev Config with the service after the application is deployed.

例子

The bookinfo application we used above has several workloads which are deployment type. Now, let us configure them as follows.

Apart from the above minimized configurations, we introduce an array named services, in which the elements are Dev Config .

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
application:
  name: bookinfo
  manifestType: rawManifestGit
  resourcePath: ["manifest/templates"]

  services:
    - name: productpage
      serviceType: deployment
      containers:
        - name: productpage
          dev:
            gitUrl: https://e.coding.net/nocalhost/nocalhost/bookinfo-productpage.git
            image: codingcorp-docker.pkg.coding.net/nocalhost/dev-images/python:3.7.7-slim-productpage-with-pydevd
            shell: bash
            workDir: /home/nocalhost-dev
            command:
              run:
                - ./run.sh
              debug:
                - ./debug.sh
            debug:
              remoteDebugPort: 9009
            sync:
              type: send
              filePattern:
                - ./
              ignoreFilePattern:
                - ".git"
                - ".github"
                - ".idea"
            portForward:
              - 39080:9080
            resources:
              limits:
                cpu: "1"
                memory: 1Gi
              requests:
                cpu: "0.5"
                memory: 512Mi

    - name: details
      serviceType: deployment
      containers:
        - dev:
            gitUrl: https://e.coding.net/codingcorp/nocalhost/bookinfo-details.git
            image: codingcorp-docker.pkg.coding.net/nocalhost/dev-images/ruby:2.7.1-slim
            shell: bash
            workDir: /home/nocalhost-dev
            sync:
              type: send
              filePattern:
                - ./
              ignoreFilePattern:
                - ".git"
                - ".github"
            env:
              - name: DEBUG
                value: "true"

Use the QuickStart sample to experience

The demo application embeds Dev Config in Deploy Config.

After deploying demo application, just right-click a workload under this application, such as Deployment / details. You will find that it has been configured with a series of development configurations in advance, so you can directly enter the Dev Mode based on them.