idem-k8s 2.0.0

什么是POP？

此项目使用 pop 构建，这是一个基于Python的 插件面向编程（POP） 实现。POP旨在以新的方式结合计算历史中的概念和智慧来解决现代计算问题。

更多信息

• 插件面向编程（POP）简介

• pop-awesome

• pop-create

先决条件

• Python 3.8+

• git （如果从源代码安装或为项目贡献力量）

  要为项目贡献力量并设置本地开发环境，请参阅本项目源代码库中的 CONTRIBUTING.rst。

安装

您可以使用Python包安装程序（PyPI）或从源代码安装 idem-k8s。

pip install idem-k8s

# Clone repo
git clone git@<your-project-path>/idem-k8s.git
cd idem-k8s

# Set up venv
python3 -m venv .venv
source .venv/bin/activate
pip install -e .

设置

安装后，idem-k8s执行和状态模块可通过pop hub访问。

更多信息

• 插件面向编程（POP）简介

• pop hub

要使用idem-k8s执行和状态模块来管理集群资源，您需要按照以下方式设置身份验证。

使用环境变量

将KUBE_CONFIG_PATH和KUBE_CTX环境变量设置为您的kube_config文件中找到的Kubernetes配置文件和上下文。

在Idem配置文件中

编辑Idem配置文件，在“account extras”下包含kube_config_path和context。以下示例作为指南。

acct:
  extras:
    k8s:
      default:
        kube_config_path: ~/.kube/config
        context: default

在credentials.yaml文件中

创建或编辑Idem credentials.yaml文件，将kube_config_path和context添加到Kubernetes配置文件。以下示例作为指南。

k8s:
  default:
    kube_config_path: ~/.kube/config
    context: default

有关Idem凭证文件的更多信息，包括加密和环境变量的推荐步骤，请参阅使用Idem进行身份验证

现在，您可以使用idem-k8s了。

状态

Idem SLS文件使用状态确保资源处于所需的配置。idem-k8s SLS文件支持三种状态函数：present、absent和describe。

访问状态

可以通过在idem-k8s/k8s/states中的相对位置访问状态。

例如，以下SLS文件中创建Kubernetes部署状态：

k8s_deployment.sls

nginx-deployment:
  k8s.apps.v1.deployment.present:
  - metadata:
      name: nginx-deployment
      namespace: default
  - spec:
      replicas: 3
      selector:
        match_labels:
          app: nginx
      strategy:
        rolling_update:
          max_surge: 25%
          max_unavailable: 25%
        type: RollingUpdate
      template:
        metadata:
          labels:
            app: nginx
        spec:
          containers:
          - image: nginx:1.14.20
            image_pull_policy: IfNotPresent
            name: nginx
            ports:
            - container_port: 80
              protocol: TCP
            termination_message_path: /dev/termination-log
            termination_message_policy: File
          restart_policy: Always

创建上述部署状态的Idem命令是

idem state $PWD/k8s_deployment.sls

当前支持的资源