GitLab пен Pantheon-ды қалай қосуға және Drupal және WordPress жұмыс үрдістерін оңтайландыруға болады

Pantheon-дағы қонақ әзірлеуші ​​​​құралдарын жасаушы GitLab CI/CD көмегімен WordPress орналастыруларын қалай автоматтандыру туралы әңгімелейді.

В пантеон Мен әзірлеушілермен қарым-қатынаста жұмыс істеймін, сондықтан мен WordPress және Drupal әзірлеушілеріне жұмыс процестеріндегі автоматтандыру мәселелерін шешуге көмектесудің жаңа жолдарын іздеймін. Ол үшін мен жаңа құралдармен тәжірибе жасап, тиімді жұмыс істеу үшін оларды бір-бірімен біріктіргенді ұнатамын.

Мен әзірлеушілердің бір реттік сервермен күресетінін жиі көремін.

Аралық серверді пайдалану кезегіңізді күту немесе клиенттерге: «Мына жерден қараңыз, бірақ мұнда әлі қарамаңыз» деген жазбасы бар URL мекенжайын жіберу өте қуанышты.

Multidev орталары - керемет Pantheon құралдарының бірі - бұл мәселені шешеді, өйткені олардың көмегімен сіз сұраныс бойынша Git филиалдары үшін орталарды жасай аласыз. Әрбір мультидев ортасының өзінің URL мекенжайы мен дерекқоры бар, сондықтан әзірлеушілер бір-бірінің саусақтарын баспай-ақ тыныш жұмыс істей алады, сапаны тексереді және мақұлдау алады.

Бірақ Pantheon-да нұсқаларды басқару немесе үздіксіз интеграция және орналастыру (CI/CD) құралдары жоқ. Бірақ бұл кез келген құралдарды біріктіруге болатын икемді платформа.

Мен сондай-ақ командалар әзірлеу үшін белгілі бір құралдарды, ал құрастыру және орналастыру үшін әртүрлі құралдарды қолданатынын байқадым.

Мысалы, оларда нұсқаларды басқару және CI/CD үшін әртүрлі құралдар бар. Кодты өңдеу және ақаулықтарды диагностикалау үшін скрипкамен айналысып, құралдар арасында ауысу керек.

туралы GitLab әзірлеу құралдарының толық жиынтығы бар: нұсқаларды басқару, билеттер, біріктіру сұраулары, ең жақсы CI/CD конвейері, контейнер тізілімі және т.б. Әзірлеу жұмыс процесін басқару үшін көп нәрсені ұсынатын қолданбаны әлі кездестірген жоқпын.

Мен автоматтандыруды жақсы көремін, сондықтан мен GitLab-тың негізгі филиалына міндеттемелер Pantheon-дағы негізгі әзірлеу ортасына орналастырылуы үшін Pantheon-ды GitLab-қа қосуды үйрендім. GitLab жүйесіндегі біріктіру сұраулары Pantheon ішіндегі мультидев орталарына код жасап, орналастыра алады.

Бұл оқулықта мен сізге GitLab және Pantheon арасындағы байланысты орнату және WordPress және Drupal жұмыс процесін оңтайландыру жолымен таныстырамын.

Әрине мүмкін, айна GitLab репозиторийі, бірақ біз өз қолымызбен барлау үшін бәрін жасаймыз GitLab CI және болашақта бұл құралды қолдану үшін ғана емес.

Кіріспе

Бұл пост үшін сіз Pantheon әр сайтты үш элементке бөлетінін түсінуіңіз керек: код, дерекқор және файлдар.

Кодқа WordPress ядросы, плагиндер және тақырыптар сияқты CMS файлдары кіреді. Бұл файлдар басқарылады Git репозиторийлері, Pantheon орналастырды, яғни Git-пен GitLab-тан Pantheon-ға кодты орналастыра аламыз.
Пантеондағы файлдар медиа файлдар, яғни сайтқа арналған кескіндер. Әдетте оларды пайдаланушылар жүктеп салады және Git оларды елемейді.

Тегін тіркелгі жасаңыз, туралы көбірек біліңіз Пантеон жұмыс процесі немесе демонстрацияға жазылыңыз pantheon.io сайтында.

Болжамдар

Менің Pantheon және GitLab бойынша жобам деп аталады pantheon-gitlab-blog-demo. Жоба атауы бірегей болуы керек. Мұнда біз WordPress сайтымен жұмыс істейміз. Drupal қабылдауға болады, бірақ кейбір нәрселерді өзгерту қажет болады.

қолданамын Git пәрмен жолыжәне сіз жұмыс істей аласыз графикалық интерфейс, Егер қаласаң.

Жоба жасаңыз

Алдымен жасайық GitLab жобасы (бұл туралы кейінірек ораламыз).

Қазір Pantheon сайтында WordPress веб-сайтын жасау. Содан кейін сайттың бақылау тақтасы үшін WordPress орнатамыз.

Қолдарыңыз бірдеңені өзгерту үшін қышынса, мысалы, плагиндерді алып тастаңыз немесе қосыңыз, шыдамды болыңыз. Сайт әлі GitLab-ке қосылмаған және біз барлық код өзгерістерінің GitLab арқылы өтуін қалаймыз.

WordPress-ті орнатқаннан кейін Pantheon веб-сайтының бақылау тақтасына оралыңыз және әзірлеу режимін Git-ке өзгертіңіз.

GitLab-те бастапқы міндеттеме

Енді сізге бастапқы WordPress кодын Pantheon сайтынан GitLab жүйесіне тасымалдау керек. Ол үшін біз Pantheon сайтының Git репозиторийінен кодты жергілікті түрде клондаймыз, содан кейін оны GitLab репозиторийіне жібереміз.

Оны оңайырақ және қауіпсіз ету үшін, Pantheon-ға SSH кілтін қосыңыз және біз Pantheon Git репозиторийін клондаған сайын құпия сөзді енгізудің қажеті болмайды. Сонымен бірге қазірдің өзінде GitLab жүйесіне SSH кілтін қосыңыз.

Мұны істеу үшін сайттың бақылау тақтасындағы Git арқылы клондау өрісінен пәрменді көшіру арқылы Pantheon сайтын жергілікті түрде клондаңыз.

Көмек қажет болса, құжаттаманы оқыңыз Git for Pantheon қолданбасын бастау.

Енді өзгерейік git remote originПантеонның орнына GitLab нұсқасын көрсету. Оны жасауға болады командой git remote.

GitLab жобасына өтіп, репозитарий URL мекенжайын жоба мәліметтері бетіндегі Клондау ашылмалы тізімінен көшірейік. SSH көмегімен клондау опциясын таңдайық, өйткені біз SSH кілтін конфигурациялап қойғанбыз.

Әдепкі бойынша git remote код репозиторийінің жергілікті көшірмесі үшін - origin. Мұны өзгертуге болады c git remote set-url origin [URL репозитория GitLab], мұнда жақшаның орнына нақты URL мекенжайын енгіземіз.

Соңында біз іске қосамыз git push origin master --forcePantheon-дан GitLab-қа WordPress кодын итеру үшін.

–күш опциясы тек бір рет қажет. Содан кейін командаларда git push ол GitLab-те болмайды.

Тіркелгі деректері мен айнымалы мәндерді орнату

Pantheon және GitLab жүйесіне кіру үшін жергілікті SSH кілтін қалай қосқанымызды есіңізде ме? SSH таңбалауышы GitLab және Pantheon-ға рұқсат беру үшін пайдаланылуы мүмкін.

GitLab-да тамаша құжаттама бар. Қарайық GitLab CI/CD көмегімен SSH кілттерін пайдалану туралы құжатта Docker орындаушысын пайдалану кезінде SSH кілттері бөлімі.

Енді біз алғашқы екі қадамды орындаймыз: ssh-keygen көмегімен жергілікті түрде жаңа SSH кілттер жұбын жасайық және жеке кілтті жобаға айнымалы ретінде қосамыз.

Сосын сұраймыз SSH_PRIVATE_KEY қалай GitLab CI/CD ортасының айнымалысы жоба параметрлерінде.
Үшінші және төртінші қадамдарда біз файл жасаймыз .gitlab-ci.yml келесідей мазмұнмен:

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"

Файлды әлі жасамайық .gitlab-ci.yml, содан кейін оған тағы бір нәрсе қосу керек болады.

Енді біз бесінші қадамды орындаймыз және құрастыру ортасында қол жеткізу қажет қызметтерге бірінші қадамда жасаған ашық кілтті қосыңыз.

Біздің жағдайда біз Pantheon-ға GitLab арқылы қол жеткізгіміз келеді. Біз Пантеон құжатындағы нұсқауларды орындаймыз Pantheon-ға SSH кілтін қосу және осы қадамды орындаңыз.

Есіңізде болсын: жеке SSH GitLab жүйесінде, ашық SSH Pantheon-да.

Тағы бірнеше орта айнымалыларын орнатайық. Біріншісі PANTHEON_SITE деп аталады. Оның мәні - құрылғыңыздағы Pantheon сайтының атауы.

Құрылғыдағы атау Git көмегімен клондау пәрменінің соңында берілген. Сіз сайтты жергілікті түрде клондадыңыз, сондықтан бұл жергілікті репозиторий каталогының атауы болады.

Әрі қарай, ортаның айнымалы мәнін орнатайық PANTHEON_GIT_URL. Бұл біз бұрыннан пайдаланған Pantheon сайтының Git репозиторийінің URL мекенжайы.

Тек SSH репозиторийінің URL мекенжайын енгізіңіз git clone және соңында машинадағы сайттың атауы.

Фу. Бұл аяқталды, енді біз файлымызды аяқтай аламыз .gitlab-ci.yml.

Орналастыру тапсырмасын жасаңыз

Бастапқыда GitLab CI-мен жасайтын әрекетіміз Git репозиторийлерімен бұрын жасаған ісімізге өте ұқсас. Бірақ бұл жолы Pantheon репозиторийін екінші қашықтағы Git көзі ретінде қосып, кодты GitLab-тан Pantheon-ға жіберейік.

Ол үшін конфигурация жасайық кезеңі deploy и тапсырма deploy:dev, өйткені біз Пантеондағы әзірлеу ортасына орналастырамыз. Алынған файл .gitlab-ci.yml келесідей болады:

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

Айнымалылар SSH_PRIVATE_KEY, PANTHEON_SITE и PANTHEON_GIT_URL таныс көрінуі керек - біз бұл ортаның айнымалы мәндерін ертерек орнаттық. Осы айнымалылар арқылы біз файлдағы мәндерді пайдалана аламыз .gitlab-ci.yml бірнеше рет және оларды тек бір жерде жаңарту қажет болады.

Соңында файлды қосыңыз, орындаңыз және жіберіңіз .gitlab-ci.yml GitLab жүйесінде.

Орналастыруды тексеру

Егер біз бәрін дұрыс орындасақ, тапсырма deploy:dev GitLab CI/CD-де сәтті жұмыс істейді және міндеттеме жібереді .gitlab-ci.yml Пантеонда. Қарап көрейік.

Біріктіру сұрауының ағындарын Пантеонға жіберу

Мұнда біз сүйікті Пантеон мүмкіндігін қолданамыз - multidev, мұнда сұраныс бойынша Git филиалдары үшін қосымша Pantheon орталарын жасауға болады.

Мультидевке қолжетімділік шектеулі, сондықтан бұл бөлімді өткізіп жіберуге болады. Бірақ рұқсатыңыз болса, GitLab біріктіру сұрауларынан Pantheon жүйесінде мультидев орталарын автоматты түрде жасауды орнату арқылы өнімділікті айтарлықтай арттыруға болады.

Алдымен жергілікті түрде жаңа Git тармағын жасайық git checkout -b multidev-support. Енді бір нәрсені қайтадан өзгертейік .gitlab-ci.yml.

Мен Pantheon ортасының атауына біріктіру сұрауының нөмірін қосқым келеді. Мысалы, бірінші біріктіру сұрауы mr-1, екінші - mr-2 және т.б.

Біріктіру сұрауы өзгереді, сондықтан біз Пантеон филиалдарының атауларын динамикалық түрде анықтауымыз керек. GitLab-те бұл оңай - сізге тек пайдалану керек алдын ала анықталған орта айнымалылары.

Біз аламыз $CI_MERGE_REQUEST_IIDбіріктіру сұрауының нөмірін көрсету үшін. Мұның бәрін біз бұрын көрсетілген жаһандық орта айнымалыларымен бірге қолданайық және файлдың соңына жаңа deploy:multidev тапсырмасын қосамыз. .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

Бұл біздің тапсырмамызға ұқсас болады deploy:dev, Пантеонға емес, филиал ғана жіберіледі master.

Біз жаңартылған файлды қостық және бекіттік .gitlab-ci.yml, енді GitLab-қа жаңа филиалды итерейік git push -u origin multidev-support.

Енді филиалдан жаңа біріктіру сұрауын жасайық multidev-supportбасу арқылы Біріктіру сұрауын жасаңыз.

Біріктіру сұрауын жасағаннан кейін біз CI/CD тапсырмасының қалай орындалатынын қарастырамыз deploy:multidev.

Қараңызшы, Пантеонға жаңа ағын жіберілді. Бірақ Pantheon веб-сайтының бақылау тақтасындағы мультидев бөліміне өтсек, онда біз жаңа ортаны көрмейміз.

Git филиалдары бөлімін қарастырайық.

Нәтижесінде біздің жіп mr-1 Пантеонға жетті. Бұтақтан орта құрайық mr-1.

Біз мультидев ортасын жасадық, енді GitLab-қа оралып, бөлімді қарастырайық Операциялар > Орталар. Біз жазбаларды көреміз dev и mr-1.

Себебі біз жазба қостық environment Атымен name и url CI/CD тапсырмаларына. Егер біз ашық орта белгішесін бассақ, біз Pantheon-да мультидев ортасының URL мекенжайына көшеміз.

Multidev құруды автоматтандыру

Негізінде, сіз осы жерде тоқтай аласыз және әрбір біріктіру сұрауы үшін мультидев ортасын жасауды ұмытпаңыз, бірақ бұл процесті автоматтандыруға болады.

Pantheon-да пәрмен жолы құралы бар Терминус, онда платформамен автоматты түрде жұмыс істеуге болады. Терминус пәрмен жолынан мультидев орталарын жасауға мүмкіндік береді - бұл үшін өте қолайлы GitLab CI.

Мұны тексеру үшін бізге жаңа біріктіру сұрауы қажет. пайдалана отырып, жаңа филиал жасайық git checkout -b auto-multidev-creation.

GitLab CI/CD тапсырмаларында Терминусты пайдалану үшін сізге Terminus көмегімен аутентификацияға арналған машина таңбалауышы және Терминусы бар контейнер кескіні қажет.

Пантеон машинасының токенін жасау, оны қауіпсіз жерде сақтаңыз және оны GitLab жүйесінде атымен жаһандық орта айнымалысы ретінде қосыңыз PANTHEON_MACHINE_TOKEN.

GitLab ортасының айнымалы мәндерін қосу жолын ұмытып қалсаңыз, біз анықтаған жерге оралыңыз PANTHEON_SITE.

Терминус көмегімен докер файлын жасау

Docker қолданбайтын болсаңыз немесе файлдарды ұнатпасаңыз Dockerfile, менің суретімді алыңыз registry.gitlab.com/ataylorme/pantheon-gitlab-blog-demo:latest және осы бөлімді өткізіп жіберіңіз.

GitLab-да контейнер тізілімі бар, онда жобамыз үшін Dockerfile құрастырып, орналастыра аламыз. Пантеонмен жұмыс істеу үшін Терминуспен Dockerfile жасайық.

Терминус – PHP пәрмен жолы құралы, сондықтан PHP кескінінен бастайық. Мен Терминусты Composer арқылы орнатып жатырмын, сондықтан қолданамын ресми Docker Composer кескіні. Біз жасаймыз Dockerfile келесі мазмұнмен жергілікті репозиторий каталогында:

# 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"

Бөлімдегі кескіндерді жинау және жіберу нұсқауларын орындаңыз Суреттерді құрастыру және итеру в контейнерлік тізілім құжаттамасысуретін жинау үшін Dockerfile және оны GitLab жүйесіне итеріңіз.

Бөлімді ашу Тіркеу GitLab жобасында. Егер бәрі жоспар бойынша болса, біздің имиджіміз сонда болады. Сурет тегіне сілтеме жазыңыз - бұл бізге файл үшін қажет .gitlab-ci.yml.

Бөлім script мәселеде deploy:multidev өсе бастады, сондықтан оны бөлек файлға жылжытайық. Жаңа файл жасаңыз 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

Сценарий жеке каталогта және Пантеонға интернетке кіруге рұқсат бермейді. Бізде мультидев логикасы үшін сценарий бар. Енді бөлімді жаңартайық deploy:multidev файл .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:
    # Run the multidev deploy script
    - "/bin/bash ./private/multidev-deploy.sh"
  only:
    - merge_requests

Тапсырмаларымыз жасалған теңшелетін кескінде орындалатынына көз жеткізуіміз керек, сондықтан анықтаманы қосамыз image тізілімнің URL мекенжайынан .gitlab-ci.yml. Нәтижесінде біз осындай файлмен аяқталдық .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

Қосу, міндеттеу және жіберу private/multidev-deploy.sh и .gitlab-ci.yml. Енді біз GitLab-ке ораламыз және CI/CD тапсырмасының аяқталуын күтеміз. Шыдамды болыңыз: multidev жасауға бірнеше минут кетуі мүмкін.

Содан кейін біз Пантеондағы мультидевтер тізімін қарастырамыз. О, ғажайып! Multidev ортасы mr-2 қазірдің өзінде осында.

қорытынды

Біріктіру сұрауларын ашып, орталарды автоматты түрде жасай бастағанда, менің командам әлдеқайда қызықты болды.

GitLab және Pantheon қуатты құралдарының көмегімен GitLab жүйесін Pantheon-ға автоматты түрде қосуға болады.

Біз GitLab CI/CD қолданатындықтан, жұмыс үрдісінде өсуге мүмкіндік болады. Міне, сізге бастау үшін бірнеше идея:

• Құрастыру қадамын қосыңыз.
• Автоматтандырылған тестілеуді қосыңыз.
• Код стандарттарының орындалуын қамтамасыз ету үшін тапсырма қосыңыз.
• Қосу динамикалық қолданбалы қауіпсіздік сынағы.

GitLab, Pantheon және автоматтандыру туралы ойыңызды айтыңыз.

PS Сіз білесіз бе, Terminus, Pantheon пәрмен жолы құралы, плагиндер арқылы кеңейтуге болады?

Біз Пантеондағы 2 нұсқада жақсы жұмыс жасадық Терминус құрастыру құралдарына арналған плагин GitLab қолдауымен. Әрбір жобаның параметрлерімен алаңдағыңыз келмесе, осы плагинді қолданып көріңіз және бізге v2 бета нұсқасын тексеруге көмектесіңіз. Терминус командасы үшін build:project:create Сізге тек Pantheon таңбалауышы және GitLab таңбалауышы қажет. Ол үлгі жобалардың бірін Composer және автоматтандырылған тестілеу арқылы орналастырады, GitLab, жаңа Pantheon сайтында жаңа жоба жасайды және оларды орта айнымалылары мен SSH кілттері арқылы қосады.

Автор туралы

Эндрю Тейлор әзірлеушілерге арналған құралдарды жасайды пантеон.

Ақпарат көзі: www.habr.com