Kumaha Nyambungkeun GitLab sareng Pantheon sareng Optimalkeun Alur Kerja Drupal sareng WordPress

Panyipta alat pangembang tamu kami di Pantheon nyarioskeun kumaha cara ngajadikeun otomatis panyebaran WordPress nganggo GitLab CI/CD.

В Pantheon Abdi damel dina hubungan pamekar, janten kuring sok milarian cara anyar pikeun ngabantosan pamekar WordPress sareng Drupal ngarengsekeun masalah otomatisasi dina alur kerjana. Jang ngalampahkeun ieu, kuring resep ékspérimén sareng alat-alat énggal sareng ngahijikeun aranjeunna pikeun dianggo sacara efektif.

Kuring sering ningali pamekar berjuang sareng server pementasan tunggal.

Karesepna pikeun ngadagoan péngkolan anjeun nganggo server perantara atanapi ngirim URL ka klien kalayan catetan: "Tingali di dieu, tapi henteu acan ningali ka dieu."

Lingkungan Multidev - salah sahiji alat Pantheon anu keren - ngarengsekeun masalah ieu, sabab ku aranjeunna anjeun tiasa nyiptakeun lingkungan pikeun cabang Git upami diperyogikeun. Unggal lingkungan multidev gaduh URL sareng pangkalan data sorangan, ku kituna pamekar tiasa damel sacara tenang, pariksa kualitas, sareng nampi persetujuan tanpa napak dina jari kaki masing-masing.

Tapi Pantheon teu gaduh alat pikeun kontrol versi atanapi integrasi sareng panyebaran kontinyu (CI / CD). Tapi éta mangrupikeun platform anu fleksibel anu anjeun tiasa ngahijikeun alat naon waé.

Kuring ogé perhatikeun yén tim nganggo alat-alat anu tangtu pikeun pangwangunan, sareng anu béda-béda pikeun pangumpulan sareng panyebaran.

Salaku conto, aranjeunna gaduh alat anu béda pikeun kontrol versi sareng CI / CD. Anjeun kedah rebab sareng pindah antara alat pikeun ngédit kode sareng ngadiagnosa masalah.

on GitLab Aya set pinuh ku parabot ngembangkeun: pikeun kontrol versi, tikét, requests ngagabung, a pangalusna-di-kelas CI / pipa CD, pendaptaran wadahna, jeung sagalana kawas éta. Abdi henteu acan mendakan aplikasi anu nawiskeun seueur pisan pikeun ngatur alur kerja pangembangan anjeun.

Abdi resep automation, janten kuring diajar kumaha nyambungkeun Pantheon ka GitLab supados komitmen ka cabang utama GitLab disebarkeun ka lingkungan pangembangan utama di Pantheon. Sareng ngahijikeun pamundut dina GitLab tiasa nyiptakeun sareng nyebarkeun kode ka lingkungan multidev di Pantheon.

Dina tutorial ieu, kuring bakal nunjukkeun anjeun kumaha nyetél sambungan antara GitLab sareng Pantheon sareng ngaoptimalkeun alur kerja WordPress sareng Drupal anjeun.

Tangtu mungkin, eunteung Repository GitLab, tapi urang bakal ngalakukeun sagalana jeung leungeun kami pikeun delve kana GitLab CI sarta dina mangsa nu bakal datang make alat ieu teu ukur keur deployment.

perkenalan

Pikeun tulisan ieu, anjeun kedah ngartos yén Pantheon ngarecah unggal situs kana tilu elemen: kode, pangkalan data, sareng file.

Kodeu kalebet file CMS sapertos inti WordPress, plugins, sareng téma. Berkas ieu dikokolakeun dina Repositories Git, hosted ku Pantheon, hartina urang bisa nyebarkeun kode ti GitLab mun Pantheon kalawan Git.
File dina Pantheon mangrupikeun file média, nyaéta, gambar pikeun situs éta. Biasana aranjeunna diunggah ku pangguna sareng Git teu malire aranjeunna.

Jieun akun gratis, panggihan leuwih seueur tentang Aliran kerja Pantheon atawa ngadaptar pikeun demo di pantheon.io.

Andaian

Proyék kuring dina Pantheon sareng GitLab disebut pantheon-gitlab-blog-demo. Ngaran proyék kudu unik. Di dieu urang bakal damel sareng situs WordPress. Anjeun tiasa nyandak Drupal, tapi anjeun kedah ngarobih sababaraha hal.

Kuring bakal ngagunakeun Garis paréntah Gitsareng anjeun tiasa damel di panganteur grafis, upami Anjeun kersa.

Jieun proyék

Kahiji, hayu urang nyieun Proyék GitLab (urang balik deui ka ieu engké).

ayeuna nyieun ramatloka WordPress on Pantheon. Teras we masang WordPress pikeun dasbor situs.

Lamun leungeun anjeun itching pikeun ngarobah hiji hal, contona, cabut atawa tambahkeun plugins, sabar. Situs ieu henteu acan nyambung ka GitLab, sareng kami hoyong sadaya parobihan kode ngalangkungan GitLab.

Sakali kami masang WordPress, balik deui ka dasbor situs wéb Pantheon sareng robih modeu pangembangan ka Git.

Komitmen awal dina GitLab

Ayeuna anjeun kedah nransper kode WordPress awal tina situs Pantheon ka GitLab. Jang ngalampahkeun ieu, urang clone kodeu ti gudang Git situs Pantheon lokal, lajeng dikirim ka gudang GitLab.

Pikeun ngagampangkeun sareng langkung aman, tambahkeun konci SSH ka Pantheon sarta kami moal kudu ngasupkeun sandi unggal waktos urang clone gudang Pantheon Git. Dina waktu nu sarua geus tambahkeun konci SSH kana GitLab.

Jang ngalampahkeun ieu, clone situs Pantheon sacara lokal ku nyalin paréntah ti lapangan Clone sareng Git dina dasbor situs.

Upami anjeun peryogi bantosan, baca dokuméntasi ngamimitian kalawan Git pikeun Pantheon.

Ayeuna hayu urang robih git remote originpikeun nunjuk ka GitLab tinimbang Pantheon. Éta tiasa dilakukeun командой git remote.

Hayu urang angkat ka proyék GitLab sareng salin URL gudang tina lungsur Clone dina halaman detil proyék. Hayu urang milih pilihan Klon sareng SSH, sabab kami parantos ngonpigurasi konci SSH.

sacara standar git remote pikeun salinan lokal tina gudang kode - origin. Ieu bisa dirobah c git remote set-url origin [URL репозитория GitLab], dimana tinimbang kurung urang asupkeun URL sabenerna.

Tungtungna, urang ngajalankeun git push origin master --forcepikeun nyorong kode WordPress ti Pantheon ka GitLab.

Pilihan -force ngan diperlukeun sakali. Lajeng dina tim git push eta moal on GitLab.

Nyetel kredensial sareng variabel

Émut kumaha urang nambihan konci SSH sacara lokal pikeun asup ka Pantheon sareng GitLab? Token SSH tiasa dianggo pikeun otorisasi GitLab sareng Pantheon.

GitLab gaduh dokuméntasi anu saé. Urang tingali bagian dina konci SSH nalika nganggo pelaksana Docker dina dokumen dina ngagunakeun konci SSH sareng GitLab CI / CD.

Urang ayeuna bakal ngalengkepan dua léngkah munggaran: Hayu urang ngadamel pasangan konci SSH énggal sacara lokal sareng ssh-keygen sareng tambahkeun konci pribadi salaku variabel kana proyék..

Teras we naroskeun SSH_PRIVATE_KEY kumaha Variabel lingkungan GitLab CI/CD dina setélan proyék.
Dina léngkah katilu sareng kaopat urang bakal nyiptakeun file .gitlab-ci.yml kalayan eusi sapertos kieu:

before_script:
  # See https://docs.gitlab.com/ee/ci/ssh_keys/README.html
  - eval $(ssh-agent -s)
  - echo "$SSH_PRIVATE_KEY" | tr -d 'r' | ssh-add - > /dev/null
  - mkdir -p $HOME/.ssh && echo "StrictHostKeyChecking no" >> "$HOME/.ssh/config"
  - git config --global user.email "$GITLAB_USER_EMAIL"
  - git config --global user.name "Gitlab CI"

Hayu urang teu commit file acan .gitlab-ci.yml, teras anjeun kedah nambihan anu sanés.

Ayeuna urang ngalakukeun lengkah kalima na tambahkeun konci umum anu anjeun jieun dina léngkah munggaran kana jasa anu anjeun peryogikeun aksés dina lingkungan ngawangun.

Dina kasus urang, urang hoyong ngaksés Pantheon ti GitLab. Urang turutan parentah dina dokumen Pantheon on nambahkeun hiji konci SSH mun Pantheon sareng ngalaksanakeun léngkah ieu.

Inget: SSH swasta aya di GitLab, buka SSH aya di Pantheon.

Hayu urang nyetél sababaraha variabel lingkungan. Anu kahiji disebut PANTHEON_SITE. Nilaina nyaéta nami situs Pantheon dina mesin anjeun.

Ngaran dina mesin dibéréndélkeun di tungtung Clone kalawan paréntah Git. Anjeun parantos ngaklon situs sacara lokal, janten ieu bakal janten nami diréktori gudang lokal.

Salajengna, hayu urang nyetél variabel lingkungan PANTHEON_GIT_URL. Ieu mangrupikeun URL gudang Git pikeun situs Pantheon anu kami parantos dianggo.

Lebetkeun ngan URL gudang SSH, tanpa git clone jeung ngaran situs dina mesin dina tungtungna.

Péh. Geus rengse, ayeuna urang bisa rengse file urang .gitlab-ci.yml.

Jieun tugas deployment

Anu mimitina urang bakal laksanakeun sareng GitLab CI mirip pisan sareng anu parantos dilakukeun ku repositori Git baheula. Tapi waktos ieu, hayu urang tambahkeun gudang Pantheon salaku sumber Git jauh kadua, teras nyorong kodeu ti GitLab ka Pantheon.

Jang ngalampahkeun ieu, hayu urang ngonpigurasikeun panggung deploy и tugas deploy:dev, sabab urang bakal nyebarkeun ka lingkungan ngembangkeun on Pantheon. file hasilna .gitlab-ci.yml Bakal kasampak kawas kieu:

stages:
- deploy

before_script:
  # See https://docs.gitlab.com/ee/ci/ssh_keys/README.html
  - eval $(ssh-agent -s)
  - echo "$SSH_PRIVATE_KEY" | tr -d 'r' | ssh-add - > /dev/null
  - mkdir -p $HOME/.ssh && echo "StrictHostKeyChecking no" >> "$HOME/.ssh/config"
  - git config --global user.email "$GITLAB_USER_EMAIL"
  - git config --global user.name "Gitlab CI"

deploy:dev:
  stage: deploy
  environment:
    name: dev
    url: https://dev-$PANTHEON_SITE.pantheonsite.io/
  script:
    - git remote add pantheon $PANTHEON_GIT_URL
    - git push pantheon master --force
  only:
    - master

Variabel SSH_PRIVATE_KEY, PANTHEON_SITE и PANTHEON_GIT_URL kedah katingal akrab - urang nyetél variabel lingkungan ieu saméméhna. Kalayan variabel ieu kami bakal tiasa nganggo nilai-nilai dina file .gitlab-ci.yml sababaraha kali, sarta aranjeunna ngan bakal perlu diropéa dina hiji tempat.

Tungtungna, tambahkeun, komitmen sareng kirimkeun file .gitlab-ci.yml dina GitLab.

Mariksa deployment

Lamun urang ngalakukeun sagalana neuleu, tugas deploy:dev bakal suksés dijalankeun dina GitLab CI / CD sareng ngalebetkeun komitmen .gitlab-ci.yml di Pantheon. Hayu urang tingali.

Ngirim benang pamundut gabungan ka Pantheon

Di dieu urang bakal nganggo fitur Pantheon karesep kuring − multidev, dimana anjeun tiasa nyiptakeun lingkungan Pantheon tambahan pikeun cabang Git upami diperyogikeun.

Aksés ka multidev diwatesan, ku kituna bagian ieu bisa dilewatan. Tapi upami anjeun gaduh aksés, anjeun tiasa sacara serius ningkatkeun produktivitas ku nyetél nyiptakeun otomatis lingkungan multidev dina Pantheon tina pamundut gabungan GitLab.

Mimiti urang ngadamel cabang Git énggal sacara lokal nganggo git checkout -b multidev-support. Ayeuna hayu urang ngarobah hiji hal deui .gitlab-ci.yml.

Abdi resep ngalebetkeun nomer pamundut gabungan dina nami lingkungan Pantheon. Contona, pamundut ngahiji kahiji nyaeta mr-1, kadua - mr-2 jsb.

Paménta ngagabung robih, janten urang kedah sacara dinamis nangtukeun nami cabang Pantheon. Éta gampang dina GitLab - anjeun ngan ukur kedah nganggo variabel lingkungan nu geus ditangtukeun.

Urang tiasa nyandak $CI_MERGE_REQUEST_IIDpikeun nangtukeun nomer pamundut gabungan. Hayu urang nerapkeun sadayana ieu sareng variabel lingkungan global anu kami parantosan sateuacana sareng tambahkeun panyebaran anyar: tugas multidev dina tungtung file. .gitlab-ci.yml.

deploy:multidev:
  stage: deploy
  environment:
    name: multidev/mr-$CI_MERGE_REQUEST_IID
    url: https://mr-$CI_MERGE_REQUEST_IID-$PANTHEON_SITE.pantheonsite.io/
  script:
    # Checkout the merge request source branch
    - git checkout $CI_COMMIT_REF_NAME
    # Add the Pantheon git repository as an additional remote
    - git remote add pantheon $PANTHEON_GIT_URL
    # Push the merge request source branch to Pantheon
    - git push pantheon $CI_COMMIT_REF_NAME:mr-$CI_MERGE_REQUEST_IID --force
  only:
    - merge_requests

Éta bakal sami sareng tugas urang deploy:dev, ngan cabang dikirim ka Pantheon, teu ka master.

Kami parantos nambihan sareng komitmen file anu diropéa .gitlab-ci.yml, tur ayeuna hayu urang nyorong cabang anyar ka GitLab kalawan git push -u origin multidev-support.

Ayeuna hayu urang ngadamel pamundut gabungan anyar tina cabang multidev-supportku ngaklik Jieun pamundut ngahiji.

Saanggeus nyieun pamundut ngahiji, urang tingali kumaha CI / tugas CD dieksekusi deploy:multidev.

Tingali, benang anyar parantos dikirim ka Pantheon. Tapi upami urang angkat ka bagian multidev dina dasbor situs Pantheon, urang moal ningali lingkungan anyar di dinya.

Hayu urang tingali bagian Git Cabang.

Hasilna, thread urang mr-1 geus ka Pantheon. Hayu urang nyiptakeun lingkungan tina cabang mr-1.

Kami parantos nyiptakeun lingkungan multidev, ayeuna urang uih deui ka GitLab sareng tingali bagian éta Operasi > Lingkungan. Urang bakal ningali éntri pikeun dev и mr-1.

Ieu kusabab urang ditambahkeun entri environment Kalawan ngaran name и url kana tugas CI/CD. Lamun urang klik dina ikon lingkungan kabuka, urang bakal dibawa ka URL lingkungan multidev on Pantheon.

Otomatis nyiptakeun multidev

Sacara prinsip, anjeun tiasa lirén di dieu sareng ngan émut pikeun nyiptakeun lingkungan multidev pikeun unggal pamundut gabungan, tapi prosés ieu tiasa otomatis.

Pantheon gaduh alat garis paréntah terminal, dimana anjeun tiasa damel sareng platform sacara otomatis. Terminus ngidinan Anjeun pikeun nyieun lingkungan multidev tina garis paréntah - idéal pikeun GitLab CI.

Urang peryogi pamundut gabungan anyar pikeun nguji ieu. Hayu urang nyieun cabang anyar ngagunakeun git checkout -b auto-multidev-creation.

Pikeun nganggo Terminus dina tugas GitLab CI / CD, anjeun peryogi token mesin pikeun auténtikasi sareng Terminus sareng gambar wadahna sareng Terminus.

Nyiptakeun Token Mesin Pantheon, simpen dina tempat anu aman sareng tambahkeun salaku variabel lingkungan global di GitLab kalayan nami PANTHEON_MACHINE_TOKEN.

Upami anjeun hilap kumaha cara nambihan variabel lingkungan GitLab, uih deui ka tempat anu didefinisikeun PANTHEON_SITE.

Nyiptakeun Dockerfile sareng Terminus

Upami anjeun henteu nganggo Docker atanapi henteu resep file Dockerfile, nyandak gambar kuring registry.gitlab.com/ataylorme/pantheon-gitlab-blog-demo:latest jeung skip bagian ieu.

GitLab gaduh pendaptaran wadahna, dimana urang tiasa ngawangun sareng nempatkeun Dockerfile pikeun proyék urang. Hayu urang ngadamel Dockerfile sareng Terminus pikeun damel sareng Pantheon.

Terminus mangrupikeun alat baris paréntah PHP, janten hayu urang mimitian ku gambar PHP. Kuring masang Terminus ngaliwatan Komposer, jadi kuring bakal ngagunakeun gambar resmi Docker komposer. Urang nyieun Dockerfile dina diréktori gudang lokal kalayan eusi ieu:

# Use the official Composer image as a parent image
FROM composer:1.8

# Update/upgrade apk
RUN apk update
RUN apk upgrade

# Make the Terminus directory
RUN mkdir -p /usr/local/share/terminus

# Install Terminus 2.x with Composer
RUN /usr/bin/env COMPOSER_BIN_DIR=/usr/local/bin composer -n --working-dir=/usr/local/share/terminus require pantheon-systems/terminus:"^2"

Turutan parentah pikeun assembling jeung ngirim gambar ti bagian Ngawangun sareng nyorong gambar в dokuméntasi pendaptaran wadahnapikeun ngumpulkeun gambar ti Dockerfile sareng nyorong ka GitLab.

Buka bagian pendaptaran dina proyék GitLab. Upami sadayana saluyu sareng rencana, gambar urang bakal aya. Tulis handap link ka tag gambar - urang peryogi eta pikeun file .gitlab-ci.yml.

Bagian script dina masalah deploy:multidev geus dimimitian tumuwuh, jadi hayu urang mindahkeun ka file misah. Jieun file anyar private/multidev-deploy.sh:

#!/bin/bash

# Store the mr- environment name
export PANTHEON_ENV=mr-$CI_MERGE_REQUEST_IID

# Authenticate with Terminus
terminus auth:login --machine-token=$PANTHEON_MACHINE_TOKEN

# Checkout the merge request source branch
git checkout $CI_COMMIT_REF_NAME

# Add the Pantheon Git repository as an additional remote
git remote add pantheon $PANTHEON_GIT_URL

# Push the merge request source branch to Pantheon
git push pantheon $CI_COMMIT_REF_NAME:$PANTHEON_ENV --force

# Create a function for determining if a multidev exists
TERMINUS_DOES_MULTIDEV_EXIST()
{
    # Stash a list of Pantheon multidev environments
    PANTHEON_MULTIDEV_LIST="$(terminus multidev:list ${PANTHEON_SITE} --format=list --field=id)"

    while read -r multiDev; do
        if [[ "${multiDev}" == "$1" ]]
        then
            return 0;
        fi
    done <<< "$PANTHEON_MULTIDEV_LIST"

    return 1;
}

# If the mutltidev doesn't exist
if ! TERMINUS_DOES_MULTIDEV_EXIST $PANTHEON_ENV
then
    # Create it with Terminus
    echo "No multidev for $PANTHEON_ENV found, creating one..."
    terminus multidev:create $PANTHEON_SITE.dev $PANTHEON_ENV
else
    echo "The multidev $PANTHEON_ENV already exists, skipping creating it..."
fi

naskah aya dina diréktori swasta jeung teu ngidinan aksés web ka Pantheon. Kami gaduh naskah pikeun logika multidev kami. Hayu urang ayeuna ngamutahirkeun bagian deploy:multidev file .gitlab-ci.ymljadi tétéla kieu:

deploy:multidev:
  stage: deploy
  environment:
    name: multidev/mr-$CI_MERGE_REQUEST_IID
    url: https://mr-$CI_MERGE_REQUEST_IID-$PANTHEON_SITE.pantheonsite.io/
  script:
    # Run the multidev deploy script
    - "/bin/bash ./private/multidev-deploy.sh"
  only:
    - merge_requests

Urang kedah mastikeun yén tugas urang dilaksanakeun dina gambar khusus anu diciptakeun, janten hayu urang tambahkeun definisi image ti URL pendaptaran pikeun .gitlab-ci.yml. Hasilna, urang réngsé nepi ka file kawas kieu .gitlab-ci.yml:

image: registry.gitlab.com/ataylorme/pantheon-gitlab-blog-demo:latest

stages:
- deploy

before_script:
  # See https://docs.gitlab.com/ee/ci/ssh_keys/README.html
  - eval $(ssh-agent -s)
  - echo "$SSH_PRIVATE_KEY" | tr -d 'r' | ssh-add - > /dev/null
  - mkdir -p $HOME/.ssh && echo "StrictHostKeyChecking no" >> "$HOME/.ssh/config"
  - git config --global user.email "$GITLAB_USER_EMAIL"
  - git config --global user.name "Gitlab CI"

deploy:dev:
  stage: deploy
  environment:
    name: dev
    url: https://dev-$PANTHEON_SITE.pantheonsite.io/
  script:
    - git remote add pantheon $PANTHEON_GIT_URL
    - git push pantheon master --force
  only:
    - master

deploy:multidev:
  stage: deploy
  environment:
    name: multidev/mr-$CI_MERGE_REQUEST_IID
    url: https://mr-$CI_MERGE_REQUEST_IID-$PANTHEON_SITE.pantheonsite.io/
  script:
    # Run the multidev deploy script
    - "/bin/bash ./private/multidev-deploy.sh"
  only:
    - merge_requests

Tambahkeun, komitmen jeung ngirim private/multidev-deploy.sh и .gitlab-ci.yml. Ayeuna urang balik deui ka GitLab sareng ngantosan tugas CI / CD parantos réngsé. Sabar: multidev tiasa nyandak sababaraha menit kanggo nyiptakeun.

Teras we ningali daptar multidev dina Pantheon. Duh mujijat! Lingkungan Multidev mr-2 geus di dieu.

kacindekan

Tim kuring langkung senang nalika urang ngamimitian muka pamundut gabungan sareng nyiptakeun lingkungan sacara otomatis.

Kalayan alat kuat GitLab sareng Pantheon, anjeun tiasa nyambungkeun GitLab ka Pantheon sacara otomatis.

Kusabab kami nganggo GitLab CI / CD, alur kerja urang bakal ngagaduhan rohangan pikeun tumbuh. Ieu sababaraha ideu pikeun ngamimitian anjeun:

• Tambahkeun léngkah ngawangun.
• Tambahkeun tés otomatis.
• Tambahkeun tugas pikeun mastikeun standar kode anu patepung.
• Tambihkeun nguji kaamanan aplikasi dinamis.

Pasihan abdi terang naon anu anjeun pikirkeun ngeunaan GitLab, Pantheon sareng automation.

PS Naha anjeun terang yén Terminus, alat garis paréntah Pantheon, bisa diperpanjang via plugins?

Simkuring di Pantheon geus dipigawé pakasaban alus dina versi 2 urang plugin pikeun alat ngawangun Terminal kalayan dukungan GitLab. Upami anjeun henteu hoyong ngaganggu setélan pikeun unggal proyék, cobian plugin ieu sareng bantosan kami nguji v2 béta. Pikeun tim Terminal build:project:create Anjeun ngan peryogi token Pantheon sareng token GitLab. Anjeunna bakal nyebarkeun salah sahiji conto proyék sareng Komposer sareng uji otomatis, nyiptakeun proyék énggal di GitLab, situs Pantheon énggal, sareng sambungkeun aranjeunna nganggo variabel lingkungan sareng konci SSH.

ngeunaan nyeratna

Andrew Taylor nyiptakeun alat pikeun pamekar di Pantheon.

sumber: www.habr.com