网络安全CLI后端【免费下载链接】certbotCertbot is EFFs tool to obtain certs from Lets Encrypt and (optionally) auto-enable HTTPS on your server. It can also act as a client for any other CA that uses the ACME protocol.项目地址https://gitcode.com/gh_mirrors/ce/certbot点击查看免费下载导读letstest 是 Certbot 项目自带的一套轻量级 AWS 测试农场test farm脚本用于在真实 EC2 云主机上对 Certbot 客户端进行跨发行版集成测试。通过本指南你将掌握如何用一条命令在 Ubuntu、Debian、CentOS 等多台 EC2 实例上并行克隆 Certbot 仓库、安装依赖、运行测试脚本并回收结果日志也理解其底层基于 boto3 与 Fabric 的自动化原理从而在自己的 CI 流程或发布验证中复用它。什么是 letstestletstest 是 Certbot 仓库letstest/目录下的一个独立 Python 包其pyproject.toml中的描述为 Test Certbot on different AWS images。它解决的问题非常具体Certbot 需要兼容多个 Linux 发行版与多种 HTTP 服务器Apache、Nginx 等单机单元测试无法覆盖真实的系统差异包管理器、默认配置文件路径、SELinux 策略等因此需要一个能在多种真实操作系统镜像上自动跑集成测试的设施。从 multitester.py 的模块 docstring 可以看出它的四个核心工作步骤拉起实例根据给定的 AMI 列表为不同发行版启动 EC2 实例分发仓库将 Certbot 仓库复制并部署到各实例并行执行在所有实例上运行 Certbot 测试bash 脚本收集结果记录执行过程与成功/失败状态供排错使用。整个流程由letstest/letstest/multitester.py约 520 行单一入口实现通过pyproject.toml中[project.scripts]声明的letstest letstest.multitester:main暴露为命令行工具。工作原理与整体流程四个阶段的工作流从 multitester.py 的main()函数可以还原出完整流程第一阶段准备本地仓库git 对象选择默认克隆https://github.com/certbot/certbot.git的当前分支支持通过--branch指定分支、通过--pull_request指定 PR 进行测试克隆完成后打包为le.tar.gz等待上传到远端实例所有动作在一个tempfile.mkdtemp()创建的临时目录中进行该目录同时也是日志目录。第二阶段准备 EC2 资源读取 YAML 配置文件中的targets列表通过 boto3 会话使用aws_profile指定的 IAM 配置连接 EC2选择一个合适的子网默认子网或名为certbot-subnet的子网要求开启自动分配公网 IP创建或复用名为certbot-security-group的安全组放行 TCP 22SSH与 UDP 60000-61000供 mosh 使用见 make_security_group。第三阶段并行执行测试为每个 target 启动一个独立的多进程 workermultiprocessing.Process每个 worker 通过 Fabric 的Connection建立 SSH 连接依次执行上传le.tar.gz并解压 → 设置环境变量公网 IP、私网 IP、主机名、PIP 源、OS 类型→ 上传并运行指定的测试 bash 脚本见 install_and_launch_certbot测试通过Manager.Queue传递任务与结果避免multiprocessing.Queue的潜在死锁问题。第四阶段回收与清理拉取每台实例上的 Certbot 运行日志/var/log/letsencrypt/letsencrypt.log或./certbot.log追加到每台机器对应的输出日志汇总结果为results文件格式为序号 目标名 pass/fail默认情况下终止所有 EC2 实例--saveinstances可保留实例以便人工登录排错见 cleanup。实例自毁保护机制为防止测试任务卡死导致 AWS 资源泄漏make_instance在默认非--saveinstances模式下会注入两重保险InstanceInitiatedShutdownBehavior terminate实例关机即销毁UserData写入#!/bin/bash\nshutdown -P 60实例启动 60 分钟后自动关机。同时_get_block_device_mappings会把所有 EBS 卷的DeleteOnTermination显式设为True确保实例终止时磁盘一并回收见 make_instance。安装与配置1. 准备开发环境letstest 随 Certbot 的开发环境一起安装。在按 Certbot 官方贡献文档创建本地开发环境后此包即可使用。该包依赖如下见 pyproject.tomlboto3/botocoreAWS SDK负责 EC2 资源操作fabric2SSH 执行与文件传输使用 2.x APIpyyaml解析 targets 配置文件。Python 版本要求3.10。2. 配置 AWS 凭据测试使用 AWS SDK for Pythonboto3操作 EC2需要先配置凭据。README 指向 boto3 快速入门指南核心步骤是使用 AWS CLI 配置 IAM 角色的密钥。multitester.py的 docstring 给出了完整示例multitester.pyaws configure --profile HappyHacker # 交互式输入 IAM 角色的 Access Key / Secret Key / region aws ec2 create-key-pair --profile HappyHacker --key-name MyKeyPair \ --query KeyMaterial --output text MyKeyPair.pem注意区域建议在~/.aws/config中为 profile 设置region us-east-1因为 targets.yaml 中列出的 AMI 均位于us-east-1密钥命名约定代码假定密钥文件名为keyname.pem并据此推断KEYNAME见 multitester.py因此MyKeyPair.pem对应密钥名MyKeyPair若使用环境变量方式提供凭据可将 aws_profile 参数传为SET_BY_ENV此时代码会把 PROFILE 置为None交由 boto3 默认凭据链解析。3. 准备 SSH 密钥文件还需要一个包含受信 SSH 私钥的文件即上一步create-key-pair生成的.pem文件用于 Fabric 连接实例。multitester.py通过 FabricConfig的connect_kwargs.key_filename传入该密钥见 main()。使用方法激活上述开发环境的虚拟环境后在letstest/目录下执行letstest targets/targets.yaml /path/to/your/key.pem profile name scripts/test to run对应官方 README 中的用法。执行后会在本地生成一个临时目录其路径会打印到终端包含每台实例的日志文件命名形如0_ubuntu24.04.log以及汇总结果文件results。由于要等待实例启动、安装依赖并运行完整测试整个过程耗时较长。完整命令行参数从 multitester.py 的 argparse 定义可以提取出全部参数参数必填默认值说明config_file是—AWS 服务器集群的 YAML 配置文件key_file是—AWS 密钥文件keyname.pemaws_profile是—AWS profile 名称对应~/.aws/中的配置test_script是test_apache2.sh要部署并运行的 bash 测试脚本路径--repo否https://github.com/certbot/certbot.git要测试的 Certbot git 仓库--branch否~要试跑的 git 分支--pull_request否~要试跑的 certbot/certbot PR 编号--merge_main否关闭若设置将 PR 合并进 certbot/certbot 的 main 分支后再测--saveinstances否关闭运行结束后不销毁 EC2 实例便于排错--alt_pip否空从中拉取候选发布包的 pip 源服务器测试 PR / 分支 / 主干main()中的 git 对象选择逻辑multitester.py展示了三种测试场景测 PRletstest targets.yaml key.pem profile scripts/test_apache2.sh --pull_request 1234会执行git fetch origin pull/1234/head:lePRtest并 checkout配合--merge_main会先git merge origin/main再测试这正是 PR 合入前的冒烟验证测分支--branch my-feature使用git clone --branch branch --single-branch测主干默认行为直接克隆仓库当前分支。自定义测试脚本test_script参数指向的脚本只是一段普通的 bash 脚本运行时通过环境变量接收参数。README 指出scripts/test_apache2.sh是最好的参考范例。脚本头部注释明确了注入的环境变量test_apache2.sh$OS_TYPE操作系统类型如ubuntu、centos来自 targets YAML 中的type字段$PUBLIC_IP、$PRIVATE_IP、$PUBLIC_HOSTNAME实例的公网/私网 IP 与公网主机名$PIP_EXTRA_INDEX_URL--alt_pip指定的候选发布包源。这些变量由 install_and_launch_certbot 通过 Fabric 的prefix()以export形式注入。源码注释特别说明了两点踩坑经验Fabric 的run的env参数不可用见 fabric issue #1744且prefix()会在命令间插入因此脚本内必须用 export 而非内联变量赋值。test_apache2.sh本身演示了一个完整的 Apache 集成测试脚本按 OS 类型初始化 ApacheUbuntu/Debian 系使用 apt 安装apache2并调整000-default.conf的 ServerNameCentOS 系禁用 SELinux、安装httpd mod_ssl、创建站点目录与 VirtualHost 配置引导依赖调用sudo letstest/scripts/bootstrap_os_packages.sh安装编译与运行依赖安装 Python通过 pyenv 安装 Python 3.10构建环境tools/venv.py -e acme -e certbot -e certbot-apache -e certbot-ci tox构建开发虚拟环境启动 Pebble用venv/bin/run_acme_server --http-01-port 80在本地启动 Pebble ACME 测试服务器并轮询等待其就绪最多 150 秒运行 Certbot以 Pebble 为 ACME 服务器对$PUBLIC_HOSTNAME执行完整签发流程--register-unsafely-without-email、--redirect、--no-verify-ssl等断言与回归检查生成的options-ssl-apache.conf是否包含SSLSessionTickets验证现代 TLS 配置生效Ubuntu 上还会额外运行venv/bin/tox -e apacheconftest做 Apache 配置回归。此外脚本通过trap DumpPebbleLogsOnFailure EXIT在失败时自动倾倒 Pebble 日志方便在 CI 日志中直接定位 ACME 交互层面的问题。targets 配置文件格式targets/targets.yaml 是默认的集群定义核心结构为targets:下的列表每个 target 包含四个字段字段含义示例ami位于 us-east-1 的 AMI IDami-045a47a3b15302634name目标名用于日志命名与展示ubuntu24.04type操作系统类型传给测试脚本的$OS_TYPEubuntu/centosvirt虚拟化类型hvm或 32 位系统的paravirtual决定默认机型hvmuserSSH 登录用户名ubuntu/admin/ec2-user默认文件覆盖了 4 个目标Ubuntu 24.04、Ubuntu 22.04、Debian 12、CentOS Stream 9注释中明确说明所有机器必须使用 x86_64 架构因为 Pebble 目前不发布其他架构的镜像。机型选择逻辑在 create_client_instancetarget 中可指定machine_type覆盖否则hvm虚拟化默认使用t2.medium32 位系统默认使用c1.medium。关键实现细节与排错指引子网与安全组的自动化should_use_subnetmultitester.py要求子网满足map_public_ip_on_launch为真且要么是可用区默认子网要么名为certbot-subnet。若找不到可用子网程序会打印提示并退出——这也是自建 VPC 时最容易踩的坑需要创建开启自动分配公网 IPv4且命名为certbot-subnet的子网。安全组certbot-security-group若不存在则自动创建TCP 22 与 UDP 60000-61000存在则复用。注意源码注释提示同名安全组无法重复创建重复运行是安全的。多进程并行与日志main()使用multiprocessing.Manager().Queue分发任务官方建议避免使用原生multiprocessing.Queue因其实现缺陷在某些情况下会死锁。每个 worker 进程把 stdout 重定向到自己的日志文件test_client_process主进程通过join(5 * 60)循环等待并定期输出.以保持 CI 心跳。全部完成后输出排序后的结果任一失败则sys.exit(1)便于上层 CI 捕获失败信号。已知限制README NotesMarketplace 镜像需人工接受条款部分 AWS 官方镜像如官方 CentOS、FreeBSD 镜像需要在 AWS Marketplace 网页上接受用户条款此步骤无法自动化EC2 实例数配额AWS EC2 默认 t2/t1 实例上限为 20 台若 targets 超过该数量需通过在线表单申请提升配额。与 Certbot 生态的协作位置letstest 与仓库内其他测试设施分工明确certbot-cicertbot-integration-tests在容器/本地环境中做 ACME 端到端测试而 letstest 面向真实云主机的多发行版矩阵是 Certbot 发布前跨 OS 兼容性验证的重要一环。其测试脚本复用仓库根部的tools/venv.py构建开发环境并与 Pebble 测试 ACME 服务器配合可在不触碰生产 Lets Encrypt 服务的前提下完成完整的证书签发流程验证。letstest/scripts/version.py还提供了一个读取certbot/src/certbot/__init__.py中版本号的小工具供发布流程获取当前版本。快速上手清单aws configure --profile profile配置 IAM 凭据区域设为us-east-1aws ec2 create-key-pair ... MyKeyPair.pem创建密钥并妥善保管在 Certbot 开发环境中安装letstest包执行letstest targets/targets.yaml MyKeyPair.pem profile scripts/test_apache2.sh观察终端打印的临时日志目录等待完成失败时查看results文件与各实例日志配合--saveinstances保留实例进行人工排查。赞分享网络安全CLI后端【免费下载链接】certbotCertbot is EFFs tool to obtain certs from Lets Encrypt and (optionally) auto-enable HTTPS on your server. It can also act as a client for any other CA that uses the ACME protocol.项目地址https://gitcode.com/gh_mirrors/ce/certbot点击查看免费下载相关推荐Certbot与自动化测试使用pytest进行插件开发与集成测试Certbot与自动化测试使用pytest进行插件开发与集成测试 为什么自动化测试对Certbot插件至关重要 你是否还在手动测试Certbot插件每次更新网络安全CLI后端如何用foobox-cn打造你的专属音乐播放中心新手完全指南如何用foobox cn打造你的专属音乐播放中心新手完全指南 你是否厌倦了千篇一律的音乐播放器界面是否希望有一个既能管理本地音乐库又能收听网络电台的全能播放桌面应用音视频KeyDB高性能Redis分支5分钟快速上手与实战指南KeyDB高性能Redis分支5分钟快速上手与实战指南 KeyDB 是一个高性能的Redis分支专注于多线程、内存效率和高吞吐量。作为Redis的现代化替代数据库KV存储缓存数据存储创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考