Merge pull request #178 from amyXia1994/blog/newsletter-10-11

blog: biweekly newsletter 10.11

blog/2023-10-11-biweekly-newsletter/index.md

@@ -0,0 +1,142 @@
+---
+slug: 2023-10-11-biweekly-newsletter
+title: KCL Biweekly Newsletter (2023 09.07 - 10.11)) | v0.6.0 Is Out - Enhancement on IDE Extensions and Package Management!
+authors:
+  name: KCL Team
+  title: KCL Team
+tags: [KCL, Biweekly-Newsletter]
+---
+
+![](/img/biweekly-newsletter.png)
+
+[KCL](https://github.com/kcl-lang) is an open-source, constraint-based record and functional language that enhances the writing of complex configurations, including those for cloud-native scenarios. With its advanced programming language technology and practices, KCL is dedicated to promoting better modularity, scalability, and stability for configurations. It enables simpler logic writing and offers ease of automation APIs and integration with homegrown systems.
+
+This section will update the KCL language community's latest developments every two weeks, including features, website updates, and the latest community news, helping everyone better understand the KCL community!
+
+***KCL Website: [https://kcl-lang.io](https://kcl-lang.io)***
+
+## Overview
+
+Thank you to all contributors for their outstanding work over the past two weeks (09.07 - 10.11 2023). Here is an overview of the key content:
+
+**🔧 Language and Toolchain Updates**
+
+- **KCL v0.6.0 Release on 9/15** - Updates to the language, toolchain, and community integration. Detailed information could be found [here](/blog/2023-09-15-kcl-0.6.0-release/index.md).
+- **KCL IDE Updates** - Supports for hover tooltips on standard library and built-in functions, and quick fixes for KCL code errors. And a plugin compatible with Intellij IDEA 2023.2 is released.
+- **KCL Package Management Tool KPM Updates** - `kpm run` now could compile KCL files and embeded with the import tool.
+- **KCL Documentation Tool Updates** - The docstring Examples section is added to the output documentation.
+- **KCL Language Updates** - Optimized error message output and added suggestions for fixing some errors.
+
+**📰 Official Website and Use Case Updates**
+
+- KCL website adds v0.6.0 documentation version.
+- More KCL model examples for containers, services, and Pod Security Policy (PSP): https://github.com/kcl-lang/krm-kcl/tree/main/examples
+
+## Special Thanks
+
+The following are listed in no particular order:
+
++ Thanks to @jakezhu9 for contributing the KCL Import tool to convert Terraform Schema to KCL Schema 🙌 [https://github.com/kcl-lang/kcl-go/pull/152](https://github.com/kcl-lang/kcl-go/pull/152)
++ Thanks to @jakezhu9 for contributing the integration of the Import tool to kpm 🙌 [https://github.com/kcl-lang/kpm/pull/194](https://github.com/kcl-lang/kpm/pull/194)
++ Thanks to @zwpaper for contributions to KCL documentation and Tree Sitter Grammar 🙌 [https://github.com/kcl-lang/tree-sitter-kcl/pull/1](https://github.com/kcl-lang/tree-sitter-kcl/pull/1), etc.
++ Thanks to @mrgleeco, @ghpu, @steeling, @prahaladramji, @zwpaper, and others for valuable feedback and discussions while using KCL and the toolchain 🙌
+
+## Featured Updates
+
+### IDE Extension Updates
+
+In the recent v0.6.0 release, the KCL IDE plugin has enhanced on hover tooltips for the standard library and builtin functions, along with support for quick fixes for KCL code errors. Additionally, end-to-end tests for the language server and integration tests for the konfig repository have been added to ensure the stability and iteration of the IDE plugin. In the upcoming release, a new `kcl-language-server version` subcommand has been added to display version information. Please refer to [https://kcl-lang.io/docs/user_docs/getting-started/install/#2-install-kcl-ide-extension](https://kcl-lang.io/docs/user_docs/getting-started/install/#2-install-kcl-ide-extension) for instructions on how to upgrade and install the KCL IDE extension in various IDE platforms.
+
+![](/img/docs/tools/Ide/vs-code/hover-built-in.png)
+
+#### IntelliJ Plugin
+
+Besides, the IntelliJ plugin is now compatible with version 2023.2+ and can be downloaded from the following link: [https://github.com/kcl-lang/intellij-kcl/releases](https://github.com/kcl-lang/intellij-kcl/releases)
+
+
+### KCL Package Manager Updates
+
+The kpm run command now supports compiling KCL files and has integrated an import tool. Additionally, the `--quiet` option has been added to suppress output logs.
+
+![](/img/docs/tools/kpm/kpm-run-file.png)
+
+### KCL Language Updates
+
+In the upcoming release, the KCL compilation command has optimized error message output and added repair suggestions on some cases:
+
+![](/img/blog/2023-10-11-kcl-biweekly-newsletter/error-suggestion.png)
+
+### KCL Models Updates
+
+In the past few weeks, we have provided more usage examples for configuring and validating containers, services, and Pod Security Policy (PSP). 
+
++ readonly-root-fs
++ allowed-image-repos
++ deny-all
++ deny-endpoint-edit-default-role
++ disallow-ingress-wildcard
++ disallow-svc-lb
++ disallow-svc-node-port
++ disallowed-image-repos
++ horizontal-pod-auto-scaler
++ psp-allow-privilege-escalation
++ psp-app-armor
++ psp-capabilities
++ psp-flexvolume-drivers
++ required-image-digests
++ required-probes
++ validate-auto-mount-service-account-token
++ validate-container-limits
++ validate-container-requests
++ validate-deprecated-api
++ k8s_manifests_containers
+
+You can refer to the corresponding examples to incorporate the above configurations and validations: [https://github.com/kcl-lang/krm-kcl/tree/main/examples](https://github.com/kcl-lang/krm-kcl/tree/main/examples). Now, let's explain using the Kubectl KCL plugin and the disallow-svc-lb model. The purpose of disallow-svc-lb is to validate Service resources and disallow the use of LoadBalancer as the Service type. Write the following YAML file (manifests.yaml): 
+
+  ```yaml
+  apiVersion: krm.kcl.dev/v1alpha1
+  kind: KCLRun
+  metadata:
+    name: disallow-svc-lb
+    annotations: 
+      krm.kcl.dev/version: 0.0.1
+      krm.kcl.dev/type: validation
+      documentation: >-
+        A validation that prevents the creation of Service resources of type `LoadBalancer`
+  spec:
+    source: oci://ghcr.io/kcl-lang/disallow-svc-lb
+  ---
+  apiVersion: v1
+  kind: Service
+  metadata:
+    name: my-service
+  spec:
+    selector:
+      app.kubernetes.io/name: MyApp
+    ports:
+      - name: http
+        protocol: TCP
+        port: 80
+    type: LoadBalancer # The service type is incorrectly set to LoadBalancer.
+  ```
+Using the Kubectl KCL tool for resource validation on the client-side, we will get the following result:
+
+  ```shell
+  $ kubectl kcl check -f manifests.yaml
+  - A validation that prevents the creation of Service resources of type `LoadBalancer`, for Service: my-service
+  ```
+
+## Resources
+
+❤️ Thanks to all KCL users and community members for their valuable feedback and suggestions in the community.
+
+For more resources, please refer to
+
+- [KCL Website](https://kcl-lang.io/)
+- [KusionStack Website](https://kusionstack.io/)
+
+- [KCL 2023 Roadmap](https://kcl-lang.io/docs/community/release-policy/roadmap)
+- [KCL v0.7.0 Milestone](https://github.com/kcl-lang/kcl/milestone/7)
+- [KCL Github Issues](https://github.com/kcl-lang/kcl/issues)
+- [KCL Github Discussion](https://github.com/orgs/kcl-lang/discussions)
+- [KCL Community](https://github.com/kcl-lang/community)

i18n/zh-CN/docusaurus-plugin-content-blog/2023-10-11-biweekly-newsletter/index.md

@@ -0,0 +1,147 @@
+---
+slug: 2023-10-11-biweekly-newsletter
+title: KCL 社区开源双周报 (2023 09.07 - 10.11) | v0.6.0 版本发布 —— 更多 IDE 插件、包管理支持!
+authors:
+  name: KCL 团队
+  title: KCL 团队
+tags: [KCL, Biweekly-Newsletter]
+---
+
+![](/img/biweekly-newsletter-zh.png)
+
+[KCL](https://github.com/kcl-lang) 是一个开源的基于约束的记录及函数语言并通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写，致力于构建围绕配置的更好的模块化、扩展性和稳定性，更简单的逻辑编写，以及更简单的自动化和生态工具集成。
+
+本栏目将会双周更新 KCL 语言社区最新动态，包括功能、官网更新和最新的社区动态等，帮助大家更好地了解 KCL 社区！
+
+***KCL 官网：[https://kcl-lang.io](https://kcl-lang.io)***
+
+## 内容概述
+
+感谢所有贡献者过去两周 (2023 09.07 - 10.11) 的杰出工作，以下是重点合并内容概述
+
+**🔧 语言及工具链更新**
+- KCL v0.6.0 于 9.15 发布，更新内容包括语言、工具链、社区集成，详细内容请查看 [https://mp.weixin.qq.com/s/f6RCZqxS2iliRGIz0036yA](https://mp.weixin.qq.com/s/f6RCZqxS2iliRGIz0036yA)
+- KCL IDE 更新 - 支持对标准库和内置函数的悬停提示，支持对 KCL 代码错误的快速修复；发布适配 Intellij IDEA 2023.2 的插件版本
+- KCL 包管理工具 KPM 更新 - kpm run 支持编译 KCL 文件，并集成了导入工具
+- KCL 文档工具更新 - 支持将 docstring Examples 章节输出到文档
+- KCL 语言更新 - 优化了一些错误信息的输出，部分的错误信息中增加了修复建议
+
+**📰 官网和用例更新**
+
+- KCL 官网新增 v0.6.0 文档版本
+- KCL 模型新增容器、服务和 Pod Security Policy (PSP) 相关的配置编辑、校验 20 个 [https://github.com/kcl-lang/krm-kcl/tree/main/examples](https://github.com/kcl-lang/krm-kcl/tree/main/examples)
+
+## 特别鸣谢
+
+以下排名不分先后
+
+- 感谢 @jakezhu9 对 KCL Import 工具 Terraform Schema 到 KCL Schema 转换的贡献 🙌 *[https://github.com/kcl-lang/kcl-go/pull/152](https://github.com/kcl-lang/kcl-go/pull/152)*
+- 感谢 @jakezhu9 对 kpm 集成 Import 工具的贡献 🙌 *[https://github.com/kcl-lang/kpm/pull/194](https://github.com/kcl-lang/kpm/pull/194)*
+- 感谢 @zwpaper 对 KCL 文档和 Tree Sitter Grammar 做出的贡献 🙌 *[https://github.com/kcl-lang/tree-sitter-kcl/pull/1](https://github.com/kcl-lang/tree-sitter-kcl/pull/1)* 等
+- 感谢 @mrgleeco, @ghpu, @steeling, @prahaladramji, @zwpaper 等在使用 KCL 及工具链过程中提出的宝贵反馈和讨论 🙌
+
+## 精选更新
+
+### KCL IDE 插件更新
+
+在最近的 0.6.0 发布中，KCL IDE 插件增加了标准库和 builtin 函数的悬停提示，新增支持对 KCL 代码错误的快速修复。此外，还增加了 language Server 侧的 e2e 测试及 konfig 仓库的集成测试，以保障 IDE 插件的稳定迭代。在尚未发布的版本中，还新增了 `kcl-language-server version` 子命令以输出版本信息。欢迎升级、使用 —— KCL 在各个 IDE 平台的插件安装方式请查看[https://kcl-lang.io/docs/user_docs/getting-started/install/#2-install-kcl-ide-extension](https://kcl-lang.io/docs/user_docs/getting-started/install/#2-install-kcl-ide-extension)
+
+![](/img/docs/tools/Ide/vs-code/hover-built-in.png)
+
+#### IntelliJ 插件
+
++ IntelliJ 插件现已适配 2023.2+ 版本，您可以在下面的链接中下载安装：
+
+https://github.com/kcl-lang/intellij-kcl/releases
+
+### KCL 包管理工具
+
+kpm run 支持编译 KCL 文件，并集成了导入工具，同时增加了 —quiet 来屏蔽输出日志。
+
+![](/img/docs/tools/kpm/kpm-run-file.png)
+
+### KCL 语言更新
+
+在尚未发布的版本中，KCL 的编译命令优化了一些错误信息的输出，部分的错误信息中增加了修复建议：
+![](/img/blog/2023-10-11-kcl-biweekly-newsletter/error-suggestion.png)
+
+### KCL 模型更新
+
+近几周内，我们提供了更多针对容器、服务和 Pod Security Policy (PSP) 配置编辑及校验的使用案例。您可参照对应的示例引入以上配置和校验： [https://github.com/kcl-lang/krm-kcl/tree/main/examples](https://github.com/kcl-lang/krm-kcl/tree/main/examples)
+
+下面我们以 Kubectl KCL 插件和 disallow-svc-lb 模型进行说明，disallow-svc-lb 的作用是对 Service 资源进行校验，不允许 Service 资源的类型设置为 `LoadBalancer`，编写如下 YAML 文件 (manifests.yaml)：
+
+  ```yaml
+  apiVersion: krm.kcl.dev/v1alpha1
+  kind: KCLRun
+  metadata:
+    name: disallow-svc-lb
+    annotations: 
+      krm.kcl.dev/version: 0.0.1
+      krm.kcl.dev/type: validation
+      documentation: >-
+        A validation that prevents the creation of Service resources of type `LoadBalancer`
+  spec:
+    source: oci://ghcr.io/kcl-lang/disallow-svc-lb
+  ---
+  apiVersion: v1
+  kind: Service
+  metadata:
+    name: my-service
+  spec:
+    selector:
+      app.kubernetes.io/name: MyApp
+    ports:
+      - name: http
+        protocol: TCP
+        port: 80
+    type: LoadBalancer # 错误地设置了 LoadBalancer
+  ```
+
+通过 Kubectl KCL 工具在客户端进行资源验证：
+
+  ```shell
+  kubectl kcl apply -f manifests.yaml
+  ```
+
+我们会得到如下结果：
+
+  ```shell
+  A validation that prevents the creation of Service resources of type `LoadBalancer`, for Service: my-service
+  ```
+
+### 社区动态
+
+集成了 KCL 0.6 的 KusionStack 发布 0.9 版本，详细更新内容请查看：[https://mp.weixin.qq.com/s/nZOHdmgcfOMRf0XUXfSJ-g](https://mp.weixin.qq.com/s/nZOHdmgcfOMRf0XUXfSJ-g)
+
+### 活动预告
+
+#### KCD 杭州站 10.21 日线下活动
+
+Kubernetes Community Days（KCD）杭州站将于 10.21 举行线下活动，活动详情及报名：https://mp.weixin.qq.com/s/rnNhmT4yoO66bGYNtFtG6g
+
+#### KCL 开源双周会
+
+近期 KCL 开源双周会将于 10.12 进行，欢迎社区小伙伴踊跃参与、交流：[https://github.com/kcl-lang/community/discussions/8](https://github.com/kcl-lang/community/discussions/8)
+
+点击链接入会，或添加至会议列表：
+https://meeting.tencent.com/dm/Hc6sNpqTWnPb
+
+#腾讯会议：778-2381-6338
+
+复制该信息，打开手机腾讯会议即可参与
+
+## 其他资源
+
+❤️ 感谢所有 KCL 用户和社区小伙伴在社区中提出的宝贵反馈与建议。预计 11 月底我们会正式发布 KCL v0.7 新版本，敬请期待!
+
+更多其他资源请参考：
+
+- [KCL 网站](https://kcl-lang.io/)
+- [KusionStack 网站](https://kusionstack.io/)
+
+- [KCL 2023 路线规划](https://kcl-lang.io/docs/community/release-policy/roadmap)
+- [KCL v0.7.0 Milestone](https://github.com/kcl-lang/kcl/milestone/7)
+- [KCL Github Issues](https://github.com/kcl-lang/kcl/issues)
+- [KCL Github Discussion](https://github.com/orgs/kcl-lang/discussions)
+- [KCL Community](https://github.com/kcl-lang/community)