使用Kind在Kubernetes中搭建Ansible AWX开发环境-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00395/article/details/148377871

使用Kind在Kubernetes中搭建Ansible AWX开发环境

awx AWX provides a web-based user interface, REST API, and task engine built on top of Ansible. It is one of the upstream projects for Red Hat Ansible Automation Platform. 项目地址: https://gitcode.com/gh_mirrors/aw/awx

前言

对于Ansible AWX项目的开发者来说，搭建一个本地开发环境是进行代码修改和功能测试的基础。本文将详细介绍如何使用Kind（Kubernetes in Docker）在本地快速搭建AWX开发环境，帮助开发者高效地进行AWX项目的开发和调试。

环境准备

系统要求

操作系统：MacOS或Linux（本文以Fedora为例）
已安装Docker环境
基本的Kubernetes知识

Kind集群安装

Kind是一个使用Docker容器作为"节点"运行本地Kubernetes集群的工具。安装Kind非常简单：

# 安装Kind
curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.11.1/kind-linux-amd64
chmod +x ./kind
mv ./kind /usr/local/bin/kind

配置Kind集群

创建集群配置文件

我们需要创建一个Kind集群配置文件kind-cluster.yaml，其中包含以下关键配置：

将本地AWX源代码目录挂载到容器中
设置端口映射，方便本地访问

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
- role: control-plane
  extraMounts:
  - hostPath: /path/to/awx
    containerPath: /awx_devel
  extraPortMappings:
  - containerPort: 30080
    hostPort: 30080

启动Kind集群

使用以下命令创建集群：

kind create cluster --config kind-cluster.yaml

验证AWX源代码是否成功挂载：

docker exec -it kind-control-plane ls /awx_devel

部署AWX Operator

AWX Operator是管理AWX实例生命周期的Kubernetes Operator。

准备工作

首先安装必要的Python依赖：

pip install openshift

部署Operator

有两种方式部署Operator：

使用官方发布版本：

git clone <awx-operator仓库>
cd awx-operator
git checkout <最新版本标签>
make deploy

自定义构建Operator镜像（适用于修改Operator代码的情况）：

export IMAGE_TAG_BASE=quay.io/<username>/awx-operator
make docker-build docker-push deploy

验证Operator部署状态：

kubectl get deployments

部署AWX实例

使用预构建镜像

如果不需要修改AWX Dockerfile，可以直接使用官方提供的开发镜像：

ansible-playbook ansible/instantiate-awx-deployment.yml \
   -e development_mode=yes \
   -e image=ghcr.io/ansible/awx_kube_devel \
   -e image_version=devel \
   -e image_pull_policy=Always \
   -e service_type=nodeport \
   -e namespace=awx \
   -e nodeport_port=30080

自定义AWX开发镜像

如果需要修改AWX Dockerfile，需要构建自定义镜像：

export DEV_DOCKER_TAG_BASE=quay.io/<USERNAME>
export COMPOSE_TAG=<IMAGE_TAG>

# 构建并推送镜像
make awx-kube-dev-build
docker push $DEV_DOCKER_TAG_BASE/awx_kube_devel:$COMPOSE_TAG

# 使用自定义镜像部署
ansible-playbook ansible/instantiate-awx-deployment.yml \
   -e development_mode=yes \
   -e image=$DEV_DOCKER_TAG_BASE/awx_kube_devel \
   -e image_version=$COMPOSE_TAG \
   -e image_pull_policy=Always \
   -e service_type=nodeport \
   -e namespace=$NAMESPACE

迭代开发提示：修改Dockerfile后，只需重新构建推送镜像并删除AWX Pod，Kubernetes会自动创建新Pod使用最新镜像。

访问和调试

访问AWX Web界面

部署完成后，可以通过以下URL访问AWX Web界面：

http://localhost:30080

获取管理员密码：

kubectl get secrets awx-admin-password -o json | jq '.data.password' | xargs | base64 -d

日志查看

查看任务容器日志：

kubectl logs -f deployment/awx-task -n awx -c awx-task

查看Web容器日志：

kubectl logs -f deployment/awx-web -n awx -c awx-web

进入容器调试

进入任务容器：

kubectl exec -it deployment/awx -n awx -c awx-task bash

开发技巧

热重载：AWX应用支持热重载，修改代码后会自动重新加载
错误恢复：如果应用因语法错误等致命问题崩溃，可以删除Pod让其自动重建
```
kubectl delete pod -l app.kubernetes.io/component=awx
```
多副本日志查看：建议安装stern工具查看多副本日志