pg_buildext - Online în cloud

PROGRAM:

NUME

pg_buildext - Construiește și instalează o extensie PostgreSQL

REZUMAT

pg_buildext [Opțiuni] acțiune [Opțiuni]

DESCRIERE

pg_buildext este un script care va construi o extensie PostgreSQL într-un mod VPATH, pentru
posibil mai multe versiuni de server PostgreSQL în paralel. Se construiește pentru
intersecție de versiuni cunoscute în debian/pgversions (versiuni acceptate de pachet)
și în /usr/share/postgresql-common/supported-versions (versiunile acceptate în acest
eliberare).

UTILIZARE

Pachetele care folosesc pg_buildext ar trebui să fie pregătit să construiască binare pentru versiunile PostgreSQL
care nu sunt prezente în Debian instabile, de exemplu pentru versiuni mai vechi când se construiesc backport-uri
pentru Debian (vechi) stabil (incluzând posibil backport-uri ale versiunilor mai noi PostgreSQL) sau pentru
toate versiunile PostgreSQL atunci când pachetul este construit pentru apt.postgresql.org.

Deoarece setul de pachete binare depinde de versiunile țintă PostgreSQL, debian/control este
generat dintr-un șablon în debian/control.in când pg_buildext updatecontrol este rulat.
Aparițiile de PGVERSION secțiunile din pachet sunt înlocuite cu PostgreSQL țintă
versiune. Includeți /usr/share/postgresql-common/pgxs_debian_control.mk în debian/rules pentru a
rulați o verificare la momentul construirii dacă este necesară actualizarea debian/control.

As pg_buildext invocă face pentru construi, instala și curat actiuni, invocari din
debian/rules (care este un makefile) ar trebui să fie prefixat cu + astfel încât sub-facii să poată vorbi
cu make jobserver.

Multe extensii suportă face installcheck testarea folosind pg_regress. Deoarece aceasta are nevoie de
pachetul care urmează să fie instalat, nu poate fi rulat în timpul construirii. În schimb, testele ar trebui să fie efectuate
folosind autopkgtest din debian/tests/*.

Dacă debian/tests/control.in există, aparițiile numelor de pachete care conțin PGVERSION sunt
înlocuit cu liste de nume de pachete cu versiunile țintă PostgreSQL completate. (Dacă nu
înlocuirea este necesară în debian/tests/control, este bine să furnizați fișierul de control al testelor
direct.)

OPŢIUNI

-cio arg
-s Transferat la pg_virtualenv la alergare installcheck.

ACȚIUNI

Cele mai multe acțiuni se așteaptă la un nume de director unde să construiască sursele. Va fi creat pentru
tu dacă nu există. Dacă build-dir conține un semn %v, acesta va fi înlocuit de
versiune specifică de PostgreSQL fiind construită împotriva. (De obicei, acest parametru este build-%v.)

versiuni suportate
Tipăriți lista efectivă a versiunilor acceptate, adică intersecția seturilor de
versiuni suportate de sistem și pachet.

checkcontrol
Verificați dacă debian/control necesită actualizare de la debian/control.in. Aceasta este invocată de la
/usr/share/postgresql-common/pgxs_debian_control.mk. Când construiți pentru a backporturi or
pgdg suite determinată de debian/changelog, această acțiune actualizează și controlul
fişier. In caz contrar, updatecontrol trebuie rulat manual.

updatecontrol
Actualizați debian/control de la debian/control.in și debian/tests/control de la
debian/tests/control.in dacă acesta din urmă există.

configura build-dir [opțiuni-extra-configure]
Pentru fiecare versiune acceptată, sunați ../configurează de la build-dir director. (Cel mai
Extensiile PostgreSQL nu au un script de configurare.)

construi build-dir [extra-cflags]
Construiți extensia în build-dir director.

instala build-dir pachet-model
invoca face instala de la build-dir director. Al treilea parametru specifică
numele pachetului de utilizat. Cele mai multe pachete folosesc postgresql-%v-pkgname. Make va fi sunat cu
DESTDIR="$(CURDIR)/debian/pachet".

curat build-dir
Curățați directorul de compilare.

buclă pachet-model
Ca variantă la apel construi si instala separat pentru versiunile VPATH, bucla peste
versiuni PostgreSQL acceptate în directorul sursă de top. Acesta ar trebui folosit dacă
pachetul nu acceptă versiuni VPATH. Așa cum invocă și el face instala, ar trebui să fie
plasat în cazul în care instalarea are loc în debian/rules, mai degrabă decât în ​​cazul în care construirea
în mod normal să fie numit.

installcheck [build-dir]
Utilizare pg_virtualenv face installcheck pentru a rula testele de regresie a extensiilor. Aceasta este
menit să fie rulat din debian/tests/control folosind autopkgtest. Dacă build-dir este omis,
este utilizat directorul sursă de sus.

Uneori este de dorit să rulați cod suplimentar pentru fiecare versiune înainte de a invoca acțiunea, în
în acest caz, bucla peste versiunile suportate trebuie să fie în scriptul de apelare. La
facilitează acest mod, acțiunile pot fi numite și ca acțiune-versiune. Vezi verificarea instalării
exemplu de mai jos.

SPRIJINIT VERSIUNI

pg_buildext citește debian/pgversions pentru a decide ce PostgreSQL să construiască module/extensii
pentru. Acest fișier conține un număr de versiune PostgreSQL pe linie, în următoarele formate:

toate Suportă toate versiunile. Acest lucru este recomandat cu excepția cazului în care există incompatibilități cunoscute.

X Y Sprijină această versiune.

X Y+
Sprijină aceasta și toate versiunile mai mari.

#...
Comentariu.

Pentru ca o versiune să fie utilizată, aceasta trebuie să fie listată și în rezultatul lui
/usr/share/postgresql-common/supported-versions. Consultați acest fișier pentru cum să configurați
lista de versiuni acceptate pe sistemul dvs.

EXEMPLU

debian/control.in:
Sursa: postgresql-foobar
Build-Depends: debhelper, postgresql-server-dev-all (>= 153~)
XS-Testsuite: autopkgtest

Pachetul: postgresql-PGVERSION-foobar
Depinde: ${misc:Depends}, ${shlibs:Depends}, postgresql-PGVERSION

debian/pgversions:
toate

debian/rules:
#!/usr/bin/make -f

include /usr/share/postgresql-common/pgxs_debian_control.mk

# omiteți acest lucru dacă pachetul nu folosește autoconf
override_dh_auto_configure:
+pg_buildext configure build-%v "--libdir=/usr/lib/postgresql/%v/lib --datadir=/usr/share/postgresql-%v-foobar"

override_dh_auto_build:
+pg_buildext build build-%v

override_dh_auto_test:
# nimic de făcut aici, vezi în schimb debian/tests/*

override_dh_auto_install:
+pg_buildext instalează build-%v postgresql-%v-foobar

override_dh_installdocs:
dh_installdocs --all README.*

override_dh_auto_clean:
+pg_buildext curățare build-%v

%:
dh $@

debian/teste/control:
Depinde: @, postgresql-server-dev-all
Teste: installcheck
Restricții: allow-stderr

debian/tests/control.in: (Opțional)
Depinde de: @, postgresql-contrib-PGVERSION, postgresql-PGVERSION-bar
Teste: installcheck
Restricții: allow-stderr

debian/tests/installcheck:
#!/ Bin / sh
pg_buildext installcheck
# alternativ: pg_buildext installcheck build-%v

# Rularea codului suplimentar înainte de a invoca acțiunea reală:
set -e
pentru v în $(pg_buildext suportate-versions); do
test -L build-$v/sql || ln -s ../sql build-$v/
test -L build-$v/așteptat || ln -s ../construcție așteptată-$v/
pg_buildext installcheck-$v build-$v
făcut

MEDIUL

pg_buildext seturi PG_VIRTUALENV_UNSHARE=-n pentru acțiunile installcheck în mod implicit la
solicitați un nou spațiu de nume de rețea, permițând partajarea mai multor instanțe care rulează în paralel
portul 5432. Suprascriere prin setarea unei valori diferite.

COMPATIBILITATE

Mai devreme pg_buildext versiunile necesită un argument „dir sursă” după acțiune. Aceasta este
acum depreciat, dar încă acceptat (și ignorat).

pg_buildext buclă a fost introdus în postgresql-server-dev-all (>= 141~).

Utilizarea „all” sau „X.Y+” în debian/pgversions a fost introdusă în postgresql-server-dev-
toate (>= 148~).

pg_buildext installcheck a fost introdus în postgresql-server-dev-all (>= 153~).

PG_VIRTUALENV_UNSHARE=-n a fost introdus în postgresql-common (>= 170~).

Gestionarea debian/tests/control.in cu PGVERSION înlocuirea a fost introdusă în
postgresql-common (>= 171~).

Utilizați pg_buildext online folosind serviciile onworks.net