julkaisu.md

ID	post_title	author	post_excerpt	layout	permalink	published	post_date
102	Julkaisu	Roni		page	http://handbook.dude.fi/wordpress-kehitys/julkaisu	true	2017-08-04 08:11:34 -0700

Deploy-toimenpiteet

Deployn automatisointi tapahtuu Capistranon avulla, joka on osa digitoimisto/dudestack-kokonaisuutta. Ensimmäinen deploy suoritetaan aina Capistranon työkalulla, mutta esim. pienet teemapäivitykset hoidetaan suoralla sftp- tai rsync-yhteydellä.

Muutosten myötä tulee muistaa ngx-pagespeed-välimuistin tyhjennys:

sudo rm -rf /tmp/pgsp/v3/domain.fi

Uusin deployconfig tuotantoon ja stagingiin löytyvät Dropboxista, hakemistopolusta Dude/Palvelin/Deployconfigs (latest).

Vaiheet

Duden julkaisutoimenpiteet eli deploy on monivaiheinen ja varsinaista tiedonsiirtoa ja kansiorakennetta lukuunottamatta (Capistrano) enimmäkseen manuaalinen. Käsipelillä asioiden tekemisellä pyrimme varmistamaan että kaikki menee varmasti kuten pitääkin. Kokonaisuudessaan vaiheisiin kuluu testausta lukuunottamatta aikaa noin varttitunti.

26.4.2018 eteenpäin vaiheet 1, 2 on automatisoitu scripteihin (huomaathan käyttää bashia sh sijaan, sillä ubuntun sh ei tue read-komentoa):

sudo bash /etc/bin/release-site.sh

Vaihe 5 scriptiin:

sudo bash /etc/bin/ssl.sh

Huom! Vaiheiden järjestys on projektikohtainen, seuraavassa esitetty järjestys ei välttämättä päde käynnissä olevaan projektiisi. Julkaisun työvaiheet ovat seuraavat:

1. Virtualhostin luominen tuotantopalvelimelle

Kirjaudu valitulle edustapalvelimelle (ghost.dude.fi, craft.dude.fi). Ota vhost-pohja (Dropbox tai edellinen sivusto) ja tallenna vhost seuraavasti:

sudo pico -w /etc/nginx/sites-available/domain.fi
sudo ln -s /etc/nginx/sites-available/domain.fi /etc/nginx/sites-enabled/domain.fi

Kommentoi piiloon rivit ssl_certificate ja ssl_certificate_key tässä vaiheessa, sillä sertifikaattia ei voida hakea ennen kuin domain on toiminnassa. Tallenna näppäinyhdistelmillä ctrl + o ja poistu ctrl + x näppäimillä.

2. Kansioiden ja käyttöoikeuksien luominen

Luo tarvittavat kansiot:

sudo mkdir -p /var/www/domain.fi && sudo mkdir -p /var/www/domain.fi/public_html && sudo mkdir -p /var/www/domain.fi/tmp

Vaihda väliaikaisesti käyttöoikeudet itsellesi deployta varten:

sudo chown -R $(whoami) /var/www/domain.fi

Testaa syntaksivirheiltä:

sudo nginx -t

Käynnistä nginx uudelleen:

sudo service nginx restart

3. Deploy-config tiedoston asettaminen

digitoimisto/dudestackin aloitusscripti (lisää kohdassa Projektin aloitus) määrittää oletuskonffit valmiiksi, mutta julkaistaessa on hyvä tarkistaa että config on ajan tasalla. Ensin säädä siis config/deploy/production.rb -tiedosto kuntoon.

4. Nimipalvelinten ohjaus

Ylläpitoasiakkaille: Ota talteen domainin siirtoavain tai välittäjänvaihtotunnus (siirtyvä domain) tai rekisteröi uusi domain. Tämän jälkeen päivitä nimipalvelimet Cloudflarelle. Lisää @ ja www -tietueet osoittamaan valitulle palvelimelle (craft: 185.87.110.7, ghost: 185.87.110.9).

Odota kun domain tulee voimaan. Jos aikataulu on kriittinen, voit testata tuotantopalvelimen jo etukäteen lisäämällä rivin /etc/hosts-tiedostoon seuraavasti:

185.87.110.7 domain.fi www.domain.fi

5. HTTPS-sertifikaatti

Kun nimipalvelimet ovat päivittyneet, laita SSL-sertifikaatti paikalleen:

/opt/letsencrypt/certbot-auto certonly --webroot -w /var/www/domain.fi/public_html -d domain.fi -d www.domain.fi

Jos palvelimella on ohjauksia muista domaineista, lisää seuraava ennen muita location-blokkeja ohjausten server-blokkien sisään:

location /.well-known/ {
    root /var/www/domain.fi/public_html;
}

6. Tietokantatunnuksen ja käyttöoikeuksien luominen tuotantopalvelimelle

Kirjaudu tuotannon tietokantapalvelimelle (beardfish.dude.fi, faith.dude.fi) ja luo tietokanta seuraavilla komennoilla (kohtiin projektinnimi, turvallinensalasana ja edustapalvelimesta riippuen 192.168.0.5 (craft) tai 192.168.0.7 (ghost)):

CREATE USER 'käyttäjänimi'@'192.168.0.5' IDENTIFIED BY 'turvallinensalasana';
GRANT ALL PRIVILEGES ON käyttäjänimi.* TO 'tietokannannimi'@'192.168.0.5';
FLUSH PRIVILEGES;

Nämä komennot löytyvät myös kun painat ylöspäin, jos olet laittanut ne aikaisemminkin. Lopuksi kirjaudu ulos palvelimelta.

7. Luo tietokanta tuotantopalvelimelle

Kirjaudu SSH-tunneloinnin avulla (Sequel Pro) tietokantapalvelimelle. Luo tyhjä tietokanta valitsemallesi nimelle.

8. Siirrä tietokanta

Exporttaa tietokanta staging-ympäristöstä (gunship.dude.fi) ja importtaa se tuotantoympäristöön (Sequel Pro).

9. Aja ensimmäinen (initial) deploy ja lisää ympäristön määrittelyt ja tunnukset .env-tiedostoon

Tarkista tässä vaiheessa että composer.json-tiedosto on ajan tasalla ja sisältää kaikki oleelliset lisäosat. Sitten aja deploykomento projektikansiossa:

cap production deploy

Ensimmäisellä kerralla saat virheen, tämä on normaalia.

00:02 deploy:check:linked_files
      ERROR linked file /var/www/domain.fi/deploy/shared/.env does not exist on 185.87.110.7

Kopioi hakemistopolku talteen ja luo .env-tiedosto seuraavasti

sudo pico -w /var/www/domain.fi/deploy/shared/.env

Liitä .env-tiedosto projektikansiosta muuttaen saltteja ja avaimia lukuunottamatta tiedot vastaamaan tuotantoa (WP_ENV=production).

10. Siirrä ja optimoi mediakirjasto

Kirjaudu staging-palvelimelle SFTP:llä (craft.dude.fi) ja hae kuvat projektihakemistosi shared/media -kansiosta. Tämän jälkeen vedä media-kansio ImageOptimin läpi.

Siirrä optimoidut kuvat tuotantopalvelimelle /var/www/domain.fi/deploy/shared/media -kansioon.

11. Julkaisu! Aja varsinainen deploy-komento

On virallisen julkaisutoimenpiteen aika. Aja uudestaan komento:

cap production deploy

13. Ohjaa testiympäristö tuotantoon

Muokkaa testiympäristön vhostia:

sudo pico -w /etc/nginx/sites-enabled/asiakas.dude.fi

Lisää rivi:

rewrite ^/projektinnimi(.*)$ https://www.domain.fi permanent;

Testaa syntaksivirheiltä:

sudo nginx -t

Tallenna ja käynnistä nginx-prosessit uudelleen:

sudo service nginx restart

14. Loppusilaukset, käyttöoikeuksien tarkistus ja sivuston testaus

Vaihda käyttöoikeudet ja varmista samalla että tiedostojen lisääminen mediakirjastoon toimii:

sudo chown -R www-data:developers /var/www/domain.fi && sudo chown -R $(whoami) /var/www/domain.fi/public_html/content/themes && sudo chown -R $(whoami) /var/www/domain.fi/tmp && sudo chmod -R 775 /var/www/domain.fi/public_html/content && sudo chmod -R 775 /var/www/domain.fi/deploy/current/content && sudo chmod -R 775 /var/www/domain.fi/deploy/shared

Käy sivut läpi niin edustan puolella kuin wp-adminissakin ja katso että kaikki toimii. Sitten siirry käymään tarkistuslistaa läpi.

Tarkistuslista

Ennen julkaisua ja julkaisun jälkeen käydään aina seuraava tarkistuslista huolellisesti läpi. Lista löytyy myös Dropboxista, kansiosta Dude/Tärkeät asiakirjat/muut/Ennen julkaisua huomioitavaa.todo, jota on ylläpidettävä samaan tahtiin kuin alla olevaa. Dokumentin voi myös kopioida projektikansioon ja ruksata SublimeTextin PlainTasks -packagea hyödyntämällä.

Ennen julkaisua

☐ WordPress yleiset asetukset ☐ Faviconit ja muut ikonit ☐ Somejakojen fallback -kuva kohdilleen ☐ SEO sisällöt kohdilleen ☐ Testaa templatet läpi: haku, arkisto, avainsanat, ym., disabloi tarvittaessa ☐ Google Analytics ☐ Tarvittavat uudelleenohjaukset ☐ Bloggauksen muotoilujen tarkistaminen ☐ Lomakkeiden testaus ☐ Katso ettei missään lue "Etusivu", perus SEO-asiat kuntoon ☐ screenshot.png päivittäminen ☐ style.css - teeman tiedot kuosiin ☐ Optimoi kuvat ImageOptimilla/Imagify (/media ja teeman kuvakansio) ☐ Lisää maksullisien lisäosien lisenssit paikalleen ☐ WordPress-päivitykset ☐ .htaccess Redirect 301 /asiakas http://www.asiakas.fi tai nginx-redirectit, jos on ☐ Jos sopii projektiin/sovittu/saittiuudistus: kuvakaappauksia Google-näkyvyyden tilanteesta ennen julkaisua (Firefoxin full-page screenshot-toiminto) ☐ Esteettömyystestaus WAVElla ☐ Esteettömyys: Tarkista, että wp_localize_script stringit lukulaitteille (screenReaderText) ovat oikealla kielellä ☐ Aja gulp uncss kun tiedät että CSS:ään ei tule enää muutoksia ☐ SendGrid API key ja .env tarkistus ☐ Web Accessibility Checklist ☐ Testaa isoilla näytöillä ettei fontit skaalaudu liian isoksi ☐ Varmuuskopiot vanhasta saitista:

sudo pico -w /etc/nginx/sites-enabled/asiakas.dude.fi

wget --no-check-certificate --no-proxy --mirror -p --html-extension --convert-links -e robots=off -P . sivustonnimi.fi

WooCommerce

☐ Tarvittaessa: Verkkokaupan Cache ☐ Maksut päälle

Julkaisun jälkeen

☐ Ohjaa testiympäristöstä liveen: asiakas.dude.fi/asiakas -> asiakas.fi ☐ WP Rocket päälle ☐ ManageWP päälle ☐ AdminLabs -seuranta päälle ☐ Google Analytics -tsekkaus ☐ HTTPS-sertifikaatti ☐ Nopeuden testaus PageSpeed Insightin avulla ☐ Testaa nopeus KeyCDN palvelulla ☐ Lomakkeiden testaus ☐ Sähköpostiliikenteen testaus (SendGrid) ☐ Backupit päälle (muokkaa /etc/bin/backup.conf ja lisää uudelle riville sivustonnimi. , tietokannannimi) ☐ Asiakastyytyväisyyskysely (Typeform) ☐ Testaa Internet Exporer 11 ☐ Maililla tieto asiakkaalle joka kuukauden huoltokatkosta sekä status.dude.fi osoite ☐ Trello-kortti hostingeihin

Extraa

☐ "Toteutus: DUDE" footeriin, linkki ja lupa ☐ Testaa typografia blogissa, kopioi mallipohja tästä ☐ HTML:n validointi W3 validaattorilla ☐ CSS:n validointi W3C W3C CSS Validation Servicessä ☐ Estä trace- ja pingbackien lähettäminen ☐ Mikroformaatit, schemat, ks. Google Rich Snippets ☐ Käy pääpiirteittäin läpi Webdev checklist