4步上手Meson:让PostgreSQL 16 构建更现代化!

原创
2023/07/28 09:52
阅读数 2.1K
AI总结

导 读

 

从PostgreSQL 16开始,除了传统的./configure和Makefile,我们将可以选择使用现代构建系统Meson来构建PostgreSQL。

几周前,当我在为PostgreSQL开发社区补丁时,我开始练习meson,我被告知除了通常的Makefile之外,还需要更新meson.build文件这也意味着,如果您正在做开发社区功能的工作时,你需要考虑meson。今天,我将分享如何在Ubuntu 18.04上使用meson构建PostgreSQL的方法,希望对您有所帮助。

 

01 Meson vs Makefile

Makefile

  • 广泛使用、成熟和稳定。

  • Makefile语法是复杂的,编辑和维护起来很繁琐。对于非常大或复杂的项目,它可能变得难以管理。

Meson

  • 语法简洁,易于理解和编写。

  • 提供快速高效的编译过程,同时保持易用性和灵活性。

     

🔗Meson:https://mesonbuild.com/

 

02 安装

我们需要安装Meson和Ninja才能开始使用它。版本非常重要,使用过旧或过新的版本可能会导致在构建过程中出现错误。以下版本已经过确认可以正常工作(由我测试):

  • lmeson v0.57.2 (minimum meson version recommended by PostgreSQL), github download link-1

  • lninja v1.10.1, github downlad link-2

link-1:

https://github.com/mesonbuild/meson/releases/download/0.57.2/meson-0.57.2.tar.gz

link-2:

https://www.highgo.ca/2023/07/14/building-postgresql-in-a-modern-way-with-meson/

 

下载好它们后,您需要将它们添加到PATH环境变量中,并将ninja放在/usr/bin/ninja中,以便构建脚本可以找到它们

 

我也尝试过将Meson v0.57.2与更新版本的Ninja一起使用,但在构建过程中遇到了错误,因此我不能保证不同版本组合的构建是否会正常工作。::>_<::

 

03 构建

Meson构建在PostgreSQL 16中可用,这个版本尚未正式发布,因此我们需要在主PG16开发分支上使用此功能。您可以在这里克隆官方的PostgreSQL源代码。

 

如果您之前已经运行过./configure和构建了PostgreSQL,则需要通过以下方式来撤销之前的操作。

$ make maintainer-clean

 

如果您想从头开始,可以执行以下步骤:

$ git clone https://github.com/postgres/postgres.git

 

现在,我们准备进行Meson构建。我们首先设置一个文件夹(在postgres文件夹内部),用于存储所有构建输出、日志、测试输出、配置等。

 

我们还可以在设置阶段传递特殊的构建参数。这些生成参数类似于传递给经典./configure脚本的参数。例如:

cd postgres
$ meson setup build --prefix=$PWD/highgo -Dcassert=true '-DPG_TEST_EXTRA=kerberos ldap' -Dbuildtype=debug

 

--prefix命令配置安装前缀,就像./configure一样。其余的可选构建参数通过-D参数名(无空格)传递给meson。

 

我们可以使用以下命令查看可能的参数列表及其描述:

$ meson configure
WARNING: The source directory instead of the build directory was specified.
WARNING: Only the default values for the project are printed, and all command line parameters are ignored.

Core properties:
  Source dir /home/caryh/postgres

Main project options:

  Core options            Default Value        Possible Values                                               Description
  ------------            -------------        ---------------                                               -----------
  ...
  buildtype               debugoptimized       [plain, debug, debugoptimized, release, minsize, custom]      Build type to use
  ...
  cassert                 false                [truefalse]                                                 Enable assertion checks (for debugging)
  ...
  PG_TEST_EXTRA                                                                                              Enable selected extra tests
  ...

  ... and many more

 

由于我们在构建文件夹外运行meson configure因此它会向您发出警告,指出它仅打印构建的默认值和可能值。要查看当前值,我们需要在创建的文件夹中重新运行相同的命令。

cd build
$ meson configure
Core properties:
  Source dir /home/caryh/postgres
  Build dir  /home/caryh/postgres/build

Main project options:

  Core options        Current Value                                    Possible Values                                               Description
  ------------        -------------                                    ---------------                                               -----------
  ...
  buildtype           debug                                            [plain, debug, debugoptimized, release, minsize, custom]      Build type to use
  ...
  cassert             true                                             [truefalse]                                                 Enable assertion checks (for debugging)
  ...
  PG_TEST_EXTRA       kerberos ldap                                                                                                  Enable selected extra tests

  .... and many more

 

如果您需要更改任何构建参数,你也可以在构建文件夹内部进行更改,而不是像以前那样再次运行

$ meson configure -Dcassert=false

 

当我们确定了构建参数后,我们可以通过在构建文件夹中运行以下命令来构建和安装:

$ ninja
$ sudo ninja install

 

就是这样!😁

 

04 运行测试套件

我们知道PostgreSQL源代码仓库中包含了许多测试用例,以确保软件正常工作。通常,我们会分别运行make checkmake check-world来执行核心进程、扩展和前端工具的测试套件。在Meson中,所有这些都可以一次性运行。只需在构建文件夹内运行以下命令:

$ meson test
  1/257 postgresql:setup / tmp_install                                                     OK                8.48s
  2/257 postgresql:setup / install_test_files                                              OK                0.06s
  3/257 postgresql:pg_upgrade / pg_upgrade/001_basic                                       OK                0.18s   8 subtests passed
  4/257 postgresql:recovery / recovery/002_archiving                                       OK                3.61s   8 subtests passed
  5/257 postgresql:recovery / recovery/003_recovery_targets                                OK                6.73s   9 subtests passed
  6/257 postgresql:recovery / recovery/004_timeline_switch                                 OK                6.99s   3 subtests passed
  7/257 postgresql:recovery / recovery/005_replay_delay                                    OK                7.58s   3 subtests passed
  8/257 postgresql:recovery / recovery/006_logical_decoding                                OK                4.78s   20 subtests passed
  9/257 postgresql:recovery / recovery/001_stream_rep                                      OK               10.34s   59 subtests passed
 10/257 postgresql:recovery / recovery/007_sync_rep                                        OK                6.20s   11 subtests passed
 11/257 postgresql:recovery / recovery/010_logical_decoding_timelines                      OK                4.59s   13 subtests passed
 12/257 postgresql:recovery / recovery/013_crash_restart                                   OK                3.55s   18 subtests passed
 13/257 postgresql:recovery / recovery/014_unlogged_reinit                                 OK                3.72s   23 subtests passed
 14/257 postgresql:recovery / recovery/012_subtransactions                                 OK                6.63s   12 subtests passed
 15/257 postgresql:recovery / recovery/009_twophase                                        OK               11.63s   24 subtests passed
 16/257 postgresql:recovery / recovery/016_min_consistency                                 OK                4.34s   1 subtests passed
 17/257 postgresql:recovery / recovery/015_promotion_pages                                 OK                4.74s   1 subtests passed
 18/257 postgresql:recovery / recovery/008_fsm_truncation                                  OK               14.55s   1 subtests passed
 19/257 postgresql:recovery / recovery/017_shm                                             OK                5.23s   4 subtests passed

...
 36/257 postgresql:kerberos / kerberos/001_auth                                            ERROR             0.21s   (exit status 255 or signal 127 SIGinvalid)
...
236/257 postgresql:ldap_password_func / ldap_password_func/001_mutated_bindpasswd          ERROR             0.19s   (exit status 255 or signal 127 SIGinvalid)
...
249/257 postgresql:ldap / ldap/001_auth                                                    ERROR             0.17s   (exit status 255 or signal 127 SIGinvalid)
250/257 postgresql:ldap / ldap/002_bindpasswd                                              ERROR             0.18s   (exit status 255 or signal 127 SIGinvalid)
...


Ok:                 251
Expected Fail:      0
Fail:               4
Unexpected Pass:    0
Skipped:            2
Timeout:            0

 

我有 4 个与 ldap 和 kerberos 相关的测试用例,因为我没有设置这些服务,所以失败是在预料之内的。我想更多地强调这些额外的测试用例,除非我们在 $PG_TEST_EXTRA 环境变量中指定它们,否则这些用例通常不会在传统设置中运行。在传统方式中,要运行额外的测试,如 ldap 和 kerberos,我们需要执行以下操作:

 

cd src/test/ldap
$ make check PG_TEST_EXTRA=ldap

or

$ cd src/test/kerberos
$ make check PG_TEST_EXTRA=kerberos

 

默认情况下不会运行这些测试,因为它们需要设置单独的服务或者运行不安全的服务。使用Meson,如果您需要运行这些额外的测试,除非你在构建选项中明确定义 -DPG_TEST_EXTRA 为构建选项之一,不然的话以下命令将不起作用

export PG_TEST_EXTRA="ldap kerberos"
$ meson test

===> will skip ldap and kerberos tests if you did not do '-DPG_TEST_EXTRA=kerberos ldap' during meson setup

 

05 结论

🏆总体而言,Meson提供了一种现代,直观和高效的方法来构建软件项目。虽然 Makefile 仍然是一个广泛使用且功能强大的构建系统,但Meson为现代的开发工作流程提供了更简洁和用户友好的体验

展开阅读全文
加载中
点击引领话题📣 发布并加入讨论🔥
0 评论
0 收藏
0
分享
AI总结
返回顶部
顶部