概述
本文将分享一个简朴的步调,介绍如安在 PostgreSQL 中运行 SSL/TLS 回归测试。
Postgres 回归测试
每当我们想要添加新功能或进行修复时,都应该运行 PostgreSQL 提供的测试,以确保没有损坏。如果新功能或修复没有相应的测试,我们应该考虑添加一些,以确保在未来进行其他更改时不会出现题目。PostgreSQL 提供了一份全面的文档,解释了所有可用的测试。
例如,如果您想运行快速回归测试以检查任何“核心”功能是否可能存在题目,可以在构建树的临时安装中运行 make check,大概针对正在运行的 PostgreSQL 服务器运行 make installcheck。make check 和 make installcheck 仅会测试 PostgreSQL 服务器的内置功能。要对已选择构建的模块运行所有测试,包罗核心测试,您需要运行 make check-world 或 make installcheck-world,分别对应于构建树中的临时安装或正在运行的 PostgreSQL 服务器。然而,某些功能在运行 make check-world 或 make installcheck-world 时仍然不会被测试,例如与安全相关的功能、SSL、Kerberos 等。缘故原由之一是这些测试用例需要一些特殊设置。要对这些功能运行回归测试,如文档所述,您需要运行类似 make check-world PG_TEST_EXTRA='kerberos ldap ssl load_balance' 的测试。
运行 SSL/TLS 回归测试
要运行与 SSL/TLS 相关功能的回归测试,起首需要编译启用了 SSL 库的 PostgreSQL。例如,运行以下下令将使用 OpenSSL 库编译 PostgreSQL:
- git clone https://github.com/postgres/postgres.git
- cd postgres
- ./configure --prefix=/tmp/pgapp --enable-tap-tests CC="gcc -std=gnu99" --with-openssl
- make -j
- make check-world
复制代码 如果 make check-world 没题目,那么您可以通过检查 src/test/ssl/tmp_check/log 中的日志来确认是否已执行 SSL/TLS 回归测试。
- $ cat *
- [11:27:05.488](0.021s) 1..0 # SKIP Potentially unsafe test SSL not enabled in PG_TEST_EXTRA
- [11:27:05.584](0.011s) 1..0 # SKIP Potentially unsafe test SSL not enabled in PG_TEST_EXTRA
- [11:27:05.671](0.011s) 1..0 # SKIP Potentially unsafe test SSL not enabled in PG_TEST_EXTRA
复制代码 日志显示,所有三个 SSL/TLS 回归测试(001_ssltests.pl、002_scram.pl 和 003_sslinfo.pl)都已被跳过。
换句话说,如果您的修复与 SSL/TLS 相关,但您仅在修复上运行 make check-world,则可能会破坏某些 SSL/TLS 功能。要使用现有的回归测试用例测试与 SSL/TLS 相关的功能,您需要使用以下下令运行 SSL/TLS 测试:
- cd src/test/ssl
- make check PG_TEST_EXTRA=ssl
复制代码 预期结果类似于以下内容:
- # +++ tap check in src/test/ssl +++
- t/001_ssltests.pl .. ok
- t/002_scram.pl ..... ok
- t/003_sslinfo.pl ... ok
- All tests successful.
- Files=3, Tests=247, 11 wallclock secs ( 0.05 usr 0.00 sys + 2.01 cusr 1.59 csys = 3.65 CPU)
- Result: PASS
复制代码 然后,您应该在 src/test/ssl/tmp_check/log 中看到如下日志,包罗更多详细信息。
- $ ls -l
- total 164
- -rw------- 1 david david 82348 Apr 19 11:39 001_ssltests_primary.log
- -rw------- 1 david david 12408 Apr 19 11:39 002_scram_primary.log
- -rw------- 1 david david 16402 Apr 19 11:39 003_sslinfo_primary.log
- -rw-rw-r-- 1 david david 30451 Apr 19 11:39 regress_log_001_ssltests
- -rw-rw-r-- 1 david david 4921 Apr 19 11:39 regress_log_002_scram
- -rw-rw-r-- 1 david david 3880 Apr 19 11:39 regress_log_003_sslinfo
复制代码 如果过细查察日志,您可能会发现许多消息包罗 certificate,如下所示。
- $ cat tmp_check/log/* | grep certificate
- ...
- [11:39:27.633](0.000s) ok 31 - cert root file that contains two certificates, order 2: no stderr
- [11:39:27.717](0.027s) ok 36 - connect with sslcertmode=require fails without a client certificate
- [11:39:27.717](0.000s) ok 37 - connect with sslcertmode=require fails without a client certificate: matches
- [11:39:27.882](0.028s) ok 48 - mismatch between host name and server certificate sslmode=require
- ...
复制代码 如何天生 SSL/TLS 证书
然后,您可能会有疑问,好比:“证书来自哪里?”以及“证书是如何天生的?”
实际上,所有证书都是通过 src/test/ssl 目次下的 Makefile 天生的,并作为测试用例的一部分提交到 PostgreSQL。通常情况下,除非您有一些需要新证书或差别证书的更改,否则不需要重新天生它们。然后,您可以运行以下下令:
- make sslfiles-clean
- make sslfiles
复制代码 之后,如果您运行 git status,您应该会发现 src/test/ssl/ssl 目次下的所有文件都已被更改。这时,如果您运行之前的下令 make check PG_TEST_EXTRA=ssl,那么它应该会使用新天生的证书进行回归测试。我要在这里提到证书的缘故原由是,证书在 SSL/TLS 回归测试中扮演着非常紧张的角色。
总结
本文描述了运行 SSL/TLS 相关回归测试的简朴过程。您可以参考此过程对 Kerberos、LDAP 等进行类似的回归测试。
关于 IvorySQL
lvorySQL 是由瀚高股份主导研发的一款开源的兼容 Oracle 的 PostgreSQL。IvorySQL 与 PostgreSQL 国际社区紧密合作,保持与最新 PG 版本内核同步,为用户提供便捷的升级体验。基于双 Parser 架构设计,100% 与原生 PostgreSQL 兼容,支持丰富的 PostgreSQL 周边工具和扩展,并根据用户需求提供定制化工具。同时,IvorySQL 4.0 提供更全面灵活的 Oracle 兼容功能,具备高度的 SQL 和 PL/SQL 兼容性能够为企业构建更加高效、稳固和灵活的数据库解决方案。
- 官网:https://www.ivorysql.org
- GitHub(欢迎点击 star 收藏哦):https://github.com/IvorySQL/IvorySQL
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。 |