快来看看，这里有你需要的 Kubernetes 模型！

在之前的几次更新中，我们为 KCL 增加了包管理的能力，解决了如何获取和发布三方库的问题。随之而来的新问题是，在开发程序的过程中，小伙伴们往往不确定该使用哪个库解决自己的问题。在通过包管理工具使用三方库之前，需要结合具体需求和各种三方库的能力去挑选合适的库使用。因此，我们借助 ArtifactHub(artifacthub.io) 构建了一个 KCL 三方库的市场，在这个市场中，有需求的朋友们能够根据自己的需求自由选择自己需要的三方库，有想法愿意分享的朋友们，也可以在这个市场中与大家分享。接下来，我们将通过一个简单的发布应用的案例来近距离感受一下如何在 ArtifactHub 上检索 KCL 三方库，并结合库文档的内容进行 KCL 程序开发。

前置工作

安装环境

- 安装 KCL https://kcl-lang.io/docs/user_docs/getting-started/install/

- 安装 kubectl 

https://kubernetes.io/zh-cn/docs/tasks/tools/#kubectl

- 安装 minikube

 https://minikube.sigs.k8s.io/docs/start/ 

启动 minikube

使用以下命令启动minikube

1. minikube start --cache-images=true

如果您的 minikube 中没有安装 Ingress 控制器，您可以使用如下命令安装：

1. minikube addons enable ingress

HelloWorld 案例

首先，我们可以准备一个简单的 js 应用。

1. const express = require('express');

2. const app = express();

3. const port = 8080;

4. // 定义一个响应 GET 请求的路由

5. app.get('/', (req, res) => {

6. res.send('欢迎来到我的Web应用程序！');

7. });

8. // 启动服务器

9. app.listen(port, () => {

10. console.log(`Web app listening http://localhost:${port}`);

11. });

并且为这个应用准备一个镜像，并将镜像上传到镜像中心。

1. FROM node:14

2. WORKDIR /usr/src/app

3. COPY package*.json ./

4. RUN npm install

5. COPY . .

6. EXPOSE 8080

7. CMD [ "node", "app.js" ]

本文的案例中我们将使用镜像地址 ghcr.io/test/my-web-app:1.0 来展示具体的内容。完成了准备工作，我们就可以使用 KCL 编写对应的发布代码了。

使用 ArtifactHub 搜索您需要的包

首先，我想要将我的 my-web-app 应用发布，我需要借助 k8s 的三方库完成我的工作。直接在 ArtifactHub 中搜索 k8s关键字，可以看到目前提供的 k8s 的三方库。

在 k8s 模型的主页中，您可以找到关于 k8s 包的文档，不同版本等更加详细的内容。

右侧的 INSTALL 按钮为您提供了安装 k8s三方库的方式。

我们这里是使用 k8s作为包的依赖，因此如下命令进行安装：

1. kcl mod add k8s:1.28

接下来，我们需要编写发布应用对应的 deployment, service 和 ingress 三个部分。这里需要使用到我们刚才添加的 k8s包中的 Deployment, Service和 Ingress三个 schema。 

更多关于 schema  的内容可以查阅。

    - kcl schema : https://kcl-lang.io/docs/next/reference/lang/tour#schema

如果您对这三个内容不太了解，您可以直接在模型的详情页进行搜索。以 Deployment 为例，您可以在文档中看到更加详细的信息。

根据文档的内容，我们可以在 main.k 文件中编写如下 deployment

1. import k8s.api.apps.v1 as d

2. deploment = d.Deployment {

3. metadata.name = "web-app-deployment"

4. spec = {

5. selector.matchLabels = {app = "web-app"}

6. template = {

7. metadata.labels = {app = "web-app"}

8. spec.containers = [{

9. name = "web-app"

10. image = "ghcr.io/test/my-web-app:1.0"

11. ports = [{containerPort = 80}]

12. }]

13. }

14. }

15. }

关于 Service, 可以查到相关文档：

对应的 service内容如下：

1. import k8s.api.core.v1 as s

2. service = s.Service {

3. metadata.name = "web-app-service"

4. spec.selector = {"app": "web-app"}

5. spec.ports = [{

6. port: 80

7. targetPort: 8080

8. }]

9. }

关于 Ingress, 可以查到相关文档

对应的 ingress内容如下：

1. import k8s.api.networking.v1 as i

2. ingress = i.Ingress {

3. metadata.name = "web-app-ingress"

4. spec.rules = [

5. {

6. host: "web-app.example.com"

7. http.paths = [

8. {

9. path: "/"

10. pathType: "Prefix"

11. backend.service.name: "web-app-service"

12. backend.service.port: {

13. number: 8080

14. }

15. }

16. ]

17. }

18. ]

19. }

最后，在 main.k 文件中增加如下内容，将 deployment, service 和 ingress 渲染为 yaml 格式。

1. manifests.yaml_stream([

2. deployment

3. service

4. ingress

5. ])

您可以使用如下命令编译对应的 KCL 程序，并且 apply。

1. kcl run main.k | kubectl apply

进行到这里，我们已经在 ArtifactHub 的帮助下成功发布了应用 my-web-app。

最后，我们通过 kubectl 端口转发，来看一下发布的效果。使用以下命令进行转发。

1. kubectl port-forward service/web-app-service 8080:80

然后通过如下命令或者直接通过浏览器访问 http://localhost:8080 来访问我们发布的应用。

1. curl http://localhost:8080

如果您通过 curl 命令行访问，您将会获得输出：

1. $ curl http://localhost:8080

2. 欢迎来到我的Web应用程序！

如果您通过浏览器访问，您将会看到：

总结

本文通过一个简单的应用发布，为大家展示了如何在 ArtifactHub 上选择合适的 KCL 三方库，目前 ArtifactHub 上已经提供超过 150 个 KCL 三方库供大家选择，快来看看有没有你需要的 KCL 模型吧 ！

在本文提供的案例中，我们用 KCL 编写了发布应用的程序。在后续的更新中，我们将进一步通过动态参数等特性对本文中的 KCL 程序进行抽象，并且打包成一个单独的模块发布到 ArtifactHub  中，如果您也有想要与他人分享的 KCL 模块，我们将继续更新详细的步骤和指南，帮助您成功发布您的包。敬请期待 ！

往期内容回顾

欢迎来玩~ 欢迎 star ⭐️

https://github.com/kcl-lang
https://github.com/KusionStack/kusion

https://kcl-lang.io/

https://kusionstack.io/