Python 语言特定指南
本 Python 语言特定指南将教您如何使用 Docker 容器化 Python 应用程序。在本指南中,您将学习如何:
- 容器化并运行一个 Python 应用程序
- 设置一个本地环境以使用容器开发 Python 应用程序
- 使用 GitHub Actions 配置一个用于容器化 Python 应用程序的 CI/CD 流水线
- 将容器化的 Python 应用程序部署到本地 Kubernetes 以测试和调试您的部署
首先,从容器化一个现有的 Python 应用程序开始。
容器化并运行 Python 应用程序
1. 准备现有的 Python 应用程序
确保您的项目结构类似于以下内容:
my-python-app/
├── app/
│ ├── __init__.py
│ ├── main.py
├── requirements.txt
└── Dockerfile
2. 创建 Dockerfile
在项目根目录下创建一个名为 Dockerfile
的文件,并添加以下内容:
# 使用官方 Python 镜像作为基础镜像
FROM python:3.9-slim
# 设置工作目录
WORKDIR /app
# 复制依赖文件
COPY requirements.txt .
# 安装依赖
RUN pip install --no-cache-dir -r requirements.txt
# 复制应用源代码
COPY . .
# 暴露应用端口
EXPOSE 5000
# 定义运行容器时的启动命令
CMD ["python", "app/main.py"]
3. 构建 Docker 镜像
在项目根目录下运行以下命令以构建 Docker 镜像:
docker build -t my-python-app .
4. 运行容器
使用以下命令运行容器:
docker run -d -p 5000:5000 my-python-app
现在,您可以通过浏览器访问 http://localhost:5000
来查看您的应用程序。
设置本地开发环境
使用 Docker 容器来设置本地开发环境有助于确保开发环境与生产环境一致。
1. 创建 docker-compose.yml 文件
在项目根目录下创建一个名为 docker-compose.yml
的文件,并添加以下内容:
version: '3.8'
services:
app:
image: python:3.9-slim
working_dir: /app
volumes:
- .:/app
ports:
- "5000:5000"
command: python app/main.py
2. 运行 Docker Compose
在项目根目录下运行以下命令启动开发环境:
docker-compose up
现在,您的应用程序将在 http://localhost:5000
上运行,您可以进行开发并实时查看更改。
配置 CI/CD 流水线
使用 GitHub Actions 配置 CI/CD 流水线以自动化测试和部署过程。
1. 创建 GitHub Actions 工作流文件
在项目根目录下创建 .github/workflows/ci.yml
并添加以下内容:
name: CI/CD Pipeline
on:
push:
branches:
- main
pull_request:
branches:
- main
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v2
- name: Set up Python
uses: actions/setup-python@v2
with:
python-version: '3.9'
- name: Install dependencies
run: |
python -m pip install --upgrade pip
pip install -r requirements.txt
- name: Run tests
run: python -m unittest discover
- name: Build Docker image
run: docker build -t my-python-app .
- name: Push Docker image
env:
DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
run: |
echo $DOCKER_PASSWORD | docker login -u $DOCKER_USERNAME --password-stdin
docker tag my-python-app $DOCKER_USERNAME/my-python-app:latest
docker push $DOCKER_USERNAME/my-python-app:latest
确保在 GitHub 仓库中添加 Docker Hub 凭据作为秘密(secrets)。
部署到 Kubernetes
使用 Kubernetes 部署和管理容器化的 Python 应用程序。
1. 创建 Kubernetes 部署文件
在项目根目录下创建 k8s/deployment.yml
并添加以下内容:
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-python-app
spec:
replicas: 3
selector:
matchLabels:
app: my-python-app
template:
metadata:
labels:
app: my-python-app
spec:
containers:
- name: my-python-app
image: <DOCKER_USERNAME>/my-python-app:latest
ports:
- containerPort: 5000
---
apiVersion: v1
kind: Service
metadata:
name: my-python-app-service
spec:
type: NodePort
selector:
app: my-python-app
ports:
- port: 5000
targetPort: 5000
nodePort: 30002
2. 部署到 Kubernetes
使用 kubectl
命令将应用程序部署到 Kubernetes 集群:
kubectl apply -f k8s/deployment.yml
您可以通过访问 http://<NODE_IP>:30002
查看应用程序。
通过上述步骤,您已经学会了如何容器化并运行一个 Python 应用程序,设置本地开发环境,使用容器运行测试,配置 CI/CD 流水线,并将应用程序部署到 Kubernetes。