Python Flask - Demo Web应用教程

1. 项目介绍

本项目是基于Python Flask框架的一个简单Web应用。它能够提供系统信息，并展示一个实时监控屏幕，其中包括CPU、内存、IO和进程信息。该应用专为容器化和云原生演示设计，适合部署到Kubernetes环境，用于Docker演示、CI/CD流程展示、云监控和自动扩展等功能。它不仅是一个“Hello World”级别的示例，而且具有最少的先决条件，便于快速部署和使用。

2. 项目快速启动

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux、WSL或MacOS，支持bash、make等工具
• Python版本：3.8或更高
• Docker：用于容器运行或镜像构建
• Azure CLI：若需部署到Azure云平台

克隆项目

使用以下命令将项目克隆到您的开发目录中：

git clone https://github.com/benc-uk/python-demoapp.git

构建和运行

项目提供了一个标准的GNU Makefile来帮助您本地运行和构建应用。以下是一些常用的Makefile目标：

• help：显示帮助信息
• lint：进行代码检查和格式化（遇到错误时不会自动修复）
• lint-fix：尝试修复代码错误并修改代码
• image：根据Dockerfile构建容器镜像
• push：将容器镜像推送到镜像仓库
• run：本地运行服务器（使用Python和Flask）
• deploy：部署到Azure Web应用服务
• undeploy：从Azure中移除应用
• test：运行单元测试
• test-report：运行单元测试并生成报告
• test-api：运行集成API测试（服务器必须正在运行）
• clean：清理项目

例如，要构建镜像，可以使用以下命令：

make image

要本地运行应用，可以使用以下命令：

make run

应用默认监听5000端口，可以通过环境变量PORT来更改。

3. 应用案例和最佳实践

容器运行

您可以使用以下命令在容器中运行应用：

docker run --rm -it -p 5000:5000 ghcr.io/benc-uk/python-demoapp:latest

如果您希望构建自己的容器，请使用make image命令，并通过上述变量来自定义名称和标签。

Kubernetes部署

应用可以很容易地部署到Kubernetes，使用Helm可以简化部署过程。详情请参阅项目中的deploy/kubernetes/readme.md文件。

CI/CD集成

项目中提供了一套工作的CI和CD GitHub Actions工作流程。自动化构建在GitHub托管的运行器上执行。

Azure部署

项目提供了一个Bicep模板来帮助您将应用部署到Azure Web应用服务（Linux版）。快速部署可以使用以下命令：

make deploy

该命令将部署到一个名为temp-demoapps的资源组中，并使用git引用创建一个唯一的站点名称。

注意： 不建议将应用部署到Azure Web应用服务（Windows版），因为体验不佳。

4. 典型生态项目

• Python：本项目使用的编程语言。
• Docker：用于容器化应用，提供一致的开发和运行环境。
• Kubernetes：用于容器编排，便于管理和扩展容器化应用。
• Flask：一个轻量级的Web框架，用于快速构建Web应用。
• GitHub Actions：用于自动化项目的构建和部署流程。

以上就是Python Flask - Demo Web应用的详细教程。通过本教程，您可以快速上手该项目，并在自己的开发环境中运行和部署。