magtape 的安装和配置教程

项目基础介绍

MagTape 是一个 Policy-as-Code 工具，专门用于 Kubernetes。它允许用户根据一组定义的策略来评估 Kubernetes 资源，以通知和强制执行最佳实践配置。MagTape 旨在通过围绕 Open Policy Agent (OPA) 的核心功能添加额外的业务逻辑和特性，而不是与 OPA 竞争。尽管 MagTape 主要不是为了安全而设计，但它可以轻松地执行安全策略。

MagTape 使用 Python 编程语言，并且基于 Flask 框架来构建其 webhook。

项目使用的关键技术和框架

• Kubernetes Admission Webhook: MagTape 使用 Kubernetes 的 Admission Webhook 概念，在资源创建之前对资源进行验证和/或修改。
• Open Policy Agent (OPA): 作为其策略语言和引擎的基础，OPA 提供了一种用于定义策略的方式。
• Flask: 作为构建 webhook 的 web 框架。

项目安装和配置的准备工作

在开始安装 MagTape 之前，您需要确保您的系统满足以下先决条件：

• 安装了现代版本的 Kubernetes，并启用了 admissionregistration.k8s.io API。
• MutatingAdmissionWebhook 和 ValidatingAdmissionWebhook 审计控制器已添加并正确地列出在 kube-apiserver 的 admission-control 标志中。

此外，您需要具有集群管理员权限，因为 MagTape 需要创建、读取、更新和删除集群范围资源的权限。

安装步骤

1. 安装 MagTape 使用以下命令来安装 MagTape 和示例策略：

   kubectl apply -f https://raw.githubusercontent.com/tmobile/magtape/v2.4.0/deploy/install.yaml
   

   此命令会执行以下操作：

   • 创建 magtape-system 命名空间。
   • 创建集群和命名空间范围的角色和角色绑定。
   • 部署 MagTape 工作负载和相关配置。
   • 部署此回购中的示例策略。

2. 测试 MagTape 安装完成后，您可以创建一个测试命名空间并部署一些测试工作负载来测试 MagTape 的功能。

   创建测试命名空间：

   kubectl create ns test1
   kubectl label ns test1 k8s.t-mobile.com/magtape=enabled
   

   部署一个没有失败的示例工作负载：

   kubectl apply -f ./testing/deployments/test-deploy01.yaml -n test1
   

   部署一个会导致拒绝的示例工作负载：

   kubectl apply -f ./testing/deployments/test-deploy02.yaml -n test1
   

   部署一个会有失败但不会拒绝的示例工作负载：

   kubectl apply -f ./testing/deployments/test-deploy03.yaml -n test1
   

3. 查看事件 如果工作负载部署失败，您可以查看相关的事件：

   kubectl get events -n test1
   

4. 清理 如果需要移除所有 MagTape 部署的资源，可以执行以下命令：

   kubectl delete -f deploy/install.yaml
   kubectl delete validatingwebhookconfiguration magtape-webhook
   

请按照以上步骤进行操作，您应该能够成功安装和配置 MagTape。记住，快速启动安装不适用于生产环境，请根据实际需要调整配置。