Difference between revisions of "Source code repository"

From pgpool Wiki
Jump to: navigation, search
(Pgpool-II branch policy)
(17 intermediate revisions by 3 users not shown)
Line 7: Line 7:
 
== About pgpool-II source code management ==
 
== About pgpool-II source code management ==
  
=== pgpool-II version policy ===
+
=== Pgpool-II version policy ===
We releases "major version" each year, which is mostly upper compatible with the previous release, but sometimes drops or changes features, which brings certain incompatibilities with the previous releases. We represent each major version "3.x" at this point. Sometimes we call 3.x as "3.x series".
+
We release "major version" each year, which is mostly backward compatible with the previous release, Exceptions to this rule are listed in the release notes when sometimes some existing feature is dropped, depreciated or a change that brings certain incompatibilities with the older versions. The versions are numbered in the form of A.B.C where A.B is the major version number while C represents the minor version of a release. Currently pgpool-II versions are represented by A == 3 i.e 3.B.C where 3.B represents the major version number, So current releases of pgpool-II is also sometimes referred as "3. X series".
  
To absolutely identify version number, specifying "minor version" is required. The second decimal point of the version number represents the "minor version", which is used for bug fixes. Unlike major versions, we guarantee that each minor version is compatible with previous minor version. Every a few month we releases "minor version up". For example 3.5.0 is the first minor version of 3.5 series and 3.5.1 is the next minor version.
+
To absolutely identify version number, specifying the "minor version number (part C of A.B.C version string)" is important. This minor version is incremented for the bug fix release, which is roughly released every month. For example pgpool-II 3.5.0 represents the first release of pgpool-II 3.5 series and 3.5.1 is the second minor (bug fix) release of the same. Unlike major versions the new minor release is guaranteed to be 100% backward compatible with the previous minor release.
  
=== pgpool-II branch policy ===
+
=== Pgpool-II branch policy ===
  
pgpool-II source code is managed by git and hosted at [http://git.postgresql.org/gitweb PostgreSQL's git repository].
+
Pgpool-II source code is managed by git and hosted at [http://git.postgresql.org/gitweb PostgreSQL's git repository].
Currently we have several branches to track each development tree. The under development branch is [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary master branch].
+
Currently we have several branches to track each development tree. The under development branch (the candidate for next major version) is [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary master branch].
  
 
Each time new major version is released, we create a branch to maintain the previous major version. We call them as "stable branches". Currently we have following stable branches.
 
Each time new major version is released, we create a branch to maintain the previous major version. We call them as "stable branches". Currently we have following stable branches.
  
* [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=summary master]
+
* [https://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V4_0_STABLE 4.0-stable]
* [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_4_STABLE 3.4-stable]
+
* [https://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_7_STABLE 3.7-stable]
* [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_3_STABLE 3.3-stable]
+
* [https://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_6_STABLE 3.6-stable]
* [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_2_STABLE 3.2-stable]
+
* [https://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_5_STABLE 3.5-stable]
* [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_1_STABLE 3.1-stable]
+
* [https://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_4_STABLE 3.4-stable]
* [http://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_0_STABLE 3.0-stable]
+
* [https://git.postgresql.org/gitweb/?p=pgpool2.git;a=shortlog;h=refs/heads/V3_3_STABLE 3.3-stable]
 +
 
 +
=== Pgpool-II release support policy ===
 +
 
 +
The Pgpool-II project aims to fully support a major release for '''five years'''. (if you need longer support, please contact to [https://www.sraoss.co.jp/prod_serv/support/pgsql-mainte_en.php SRA OSS, Inc.]).
 +
 
 +
After a release falls out of full support, we may (at our committers' discretion) continue to apply further critical fixes to the source code, on a best-effort basis. No formal releases or binary packages will be produced by the project, but the updated source code will be available from our source code control system.
 +
 
 +
This policy will be followed on a best-effort basis. In extreme cases it may not be possible to support a release for the planned lifetime; for example if a serious bug is found that cannot be resolved in a given major version without significant risk to the stability of the code or loss of application compatibility. In such cases, early retirement of a major version may be required.
 +
 
 +
{|
 +
! Version
 +
! First release date
 +
! EOL date
 +
|-
 +
|3.7
 +
|2017/11
 +
|2022/11
 +
|-
 +
|3.6
 +
|2016/11
 +
|2021/11
 +
|-
 +
|3.5
 +
|2016/1
 +
|2021/1
 +
|-
 +
|3.4
 +
|2014/11
 +
|2019/11
 +
|-
 +
|3.3
 +
|2013/7
 +
|2018/7
 +
|-
 +
|3.2
 +
|2012/8
 +
|2017/8
 +
|-
 +
|3.1
 +
|2011/9
 +
|2016/9
 +
|}

Revision as of 05:53, 19 September 2018

Pgpool source code repository is managed by PostgreSQL's git repository.

About pgpool-II source code management

Pgpool-II version policy

We release "major version" each year, which is mostly backward compatible with the previous release, Exceptions to this rule are listed in the release notes when sometimes some existing feature is dropped, depreciated or a change that brings certain incompatibilities with the older versions. The versions are numbered in the form of A.B.C where A.B is the major version number while C represents the minor version of a release. Currently pgpool-II versions are represented by A == 3 i.e 3.B.C where 3.B represents the major version number, So current releases of pgpool-II is also sometimes referred as "3. X series".

To absolutely identify version number, specifying the "minor version number (part C of A.B.C version string)" is important. This minor version is incremented for the bug fix release, which is roughly released every month. For example pgpool-II 3.5.0 represents the first release of pgpool-II 3.5 series and 3.5.1 is the second minor (bug fix) release of the same. Unlike major versions the new minor release is guaranteed to be 100% backward compatible with the previous minor release.

Pgpool-II branch policy

Pgpool-II source code is managed by git and hosted at PostgreSQL's git repository. Currently we have several branches to track each development tree. The under development branch (the candidate for next major version) is master branch.

Each time new major version is released, we create a branch to maintain the previous major version. We call them as "stable branches". Currently we have following stable branches.

Pgpool-II release support policy

The Pgpool-II project aims to fully support a major release for five years. (if you need longer support, please contact to SRA OSS, Inc.).

After a release falls out of full support, we may (at our committers' discretion) continue to apply further critical fixes to the source code, on a best-effort basis. No formal releases or binary packages will be produced by the project, but the updated source code will be available from our source code control system.

This policy will be followed on a best-effort basis. In extreme cases it may not be possible to support a release for the planned lifetime; for example if a serious bug is found that cannot be resolved in a given major version without significant risk to the stability of the code or loss of application compatibility. In such cases, early retirement of a major version may be required.

Version First release date EOL date
3.7 2017/11 2022/11
3.6 2016/11 2021/11
3.5 2016/1 2021/1
3.4 2014/11 2019/11
3.3 2013/7 2018/7
3.2 2012/8 2017/8
3.1 2011/9 2016/9