Tenanttikohtainen kehitysympäristö suojaa tuotantoa

AI Commerce -kehitysympäristö on asiakkaan tenantille erikseen tilattava ympäristö, jossa partneri voi kokeilla ominaisuuksia ja integraatioita vaikuttamatta tuotantokaupan toimintaan. Ympäristö pyritään rakentamaan tuotantoa vastaavista palveluista, mutta sen tunnukset, ajonaikainen data ja muutokset pidetään erillään tuotannosta. Samankaltaisuus ei tarkoita, että kaikki resurssit tai tiedot olisivat samoja.

Kehitysympäristö soveltuu uuden koodin, rajapintakutsujen, asetusten ja tietomallimuutosten ennakkotarkistukseen. Se ei korvaa paikallista kehitystä eikä tuotantoonviennin hyväksyntää. Partneri sopii ennen tilausta, mitkä palvelut ympäristöön kuuluvat, mitä tuotantoresursseja voidaan jakaa ja mitkä osat eriytetään turvallisuuden tai testien toistettavuuden vuoksi.

Jokainen asiakas saa oman kehitysympäristön tenanttikohtaisesti. Ympäristö on tuotantokaupan erillinen kopio vain sovitussa laajuudessa: dataa, salaisuuksia, käyttäjäistuntoja tai tiedostoja ei pidä olettaa automaattisesti kopioiduiksi. Käyttöönoton rajaus kirjataan ympäristökohtaiseen luovutusdokumenttiin.

Kehitysympäristön verkko-osoitteet

Kehitysympäristön verkko-osoite sovitaan tenantin verkkotunnusmallin mukaan. Käytettyjä malliosoitteita ovat dev.kauppa.fi ja kauppa-dev.aicommerce.fi. Ne ovat esimerkkimuotoja, eivät yleisiä kaikille asiakkaille avautuvia osoitteita. Tilauksessa vahvistetaan varsinainen nimi, DNS-omistajuus, TLS-varmenne ja se, mille palvelulle kukin nimi ohjaa.

Asiakkaan oman verkkotunnuksen dev-aliverkkotunnus vaatii asiakkaan DNS-hallinnassa tehtävän muutoksen tai delegoinnin. AI Commerce -verkkotunnuksen alle sijoitettava nimi vaatii puolestaan yksilöllisen tenant-tunnisteen. Molemmissa malleissa kehitysympäristön kirjautumis-, API- ja verkkokauppaosoitteet voivat olla eri nimiä, joten yhtä esimerkkiosoitetta ei käytetä kaikkien palvelujen automaattisena perustana.

Älä lisää tuotannon osoitetta kehitysympäristön palautusosoitteeksi, webhook-kohteeksi tai API-alkuosoitteeksi vain siksi, että palvelut muistuttavat toisiaan. Tarkista selaimesta ja konfiguraatiosta ympäristön nimi ennen kirjoittavaa testiä. Kehitys- ja tuotanto-osoitteet merkitään testisuunnitelmaan vierekkäin sekaannusten ehkäisemiseksi.

Kehitys- ja tuotantopalvelujen eriyttäminen

Kehityspalvelujen eriyttäminen suunnitellaan API Gatewayn, CloudFrontin, S3-tallennuksen, Lambda-funktioiden, Redis-istuntojen ja tietokannan osalta. Aiemmassa mallissa API Gateway käytti tuotannosta poikkeavaa stagea, kuten dev; CloudFrontilla oli tuotannosta replikoitu mutta eri origineihin ohjaava distribuutio; ja käyttöliittymän staattisille Svelte-resursseille oli oma S3-säilö.

Lambda-funktion mallinimenä on käytetty muotoa serverless-kauppasi-dev, kun tuotantoversio päättyy tunnisteeseen -prod. Istunnot ja Redis pidetään eri instansseissa, jotta kehitys- ja tuotantokirjautumiset eivät sekoitu. Nimet ovat ympäristökohtaisia esimerkkejä: käyttöönotossa luovutetaan todelliset resurssitunnisteet eikä partneri päättele niitä nimeämismallista.

Kehitysympäristö voi käyttää erillistä tietokantaa tai erillistä kehitystaulua, esimerkiksi kauppa_dev. Näillä ratkaisuilla on erilainen eristys- ja poistumisriski, joten valinta tehdään ennen datan tuontia. Rakenteelliset päivitykset voidaan tuoda sekä kehitys- että tuotantoympäristöön, mutta liiketoimintadataa ei synkronoida niiden välillä automaattisesti.

Kehityshaara ja partnerin käyttöoikeudet

AI Commerce -kehitysympäristöä vastaavan GitHub-haaran mallinimi on kauppa-dev. Kehityshaara on tuotantohaaran kopio luontihetkellä, minkä jälkeen siihen voidaan tehdä omia committeja ja testata muutoksia ilman suoraa tuotantovaikutusta. Kopio ei pysy automaattisesti tuotannon tasalla, ellei päivitysprosessia ole erikseen sovittu.

Samoille kehittäjille voidaan antaa pääsy sekä tuotanto- että kehityshaaraan. Pääsy ei kuitenkaan saa perustua pelkkään oletukseen automaattisesta periytymisestä, vaan jokaisen henkilön repository-, ympäristö- ja julkaisuoikeudet tarkistetaan. Kehityshaaraan kirjoittaminen ja tuotantoon yhdistäminen ovat eri oikeuksia, ja tuotantoonvienti noudattaa erillistä katselmointi- ja hyväksyntäprosessia.

Kehitys- ja tuotantoympäristö voivat käyttää samaa IAM-policyä, jos sen resurssirajaukset erottavat ympäristöt turvallisesti. Yhteinen policy ei tarkoita yhteisiä tunnuksia tai rajoittamatonta pääsyä. Poikkeavat oikeudet, määräaikainen partneripääsy ja käyttöoikeuden poistaminen dokumentoidaan ympäristökohtaisesti ennen tunnusten luovutusta.

Kehitysympäristön kuvat ja muu data

Kehitysympäristö voi käyttää tuotannon kuvavarastoa, jolloin kehitystietokantaan kopioitujen tuotteiden kuvapolut viittaavat tuotannon S3-sijaintiin. Tämä vähentää tiedostojen kopiointia, mutta tekee tuotannon kuvista kehitysympäristön riippuvuuden. Jaettuun kuvavarastoon ei saa antaa kehitysympäristöstä kirjoitus- tai poisto-oikeutta ilman erillistä hyväksyntää.

Jos kehitysympäristö tarvitsee omia kuvia tai partnerin pitää testata latausta, sille valitaan oma tallennussäilö tai rajattu avainpolku. Tällöin testitiedostot eivät saa korvata tuotannon kuvia. Kuvien, staattisten käyttöliittymäresurssien ja muun liiketoimintadatan tallennusratkaisut käsitellään erikseen, vaikka kaikki käyttäisivät S3-palvelua.

Tuotetiedot tai muut tietokantarivit siirretään tuotannosta kehitysympäristöön manuaalisesti hyväksytyllä prosessilla, koska automaattista datasynkronointia ei ole. Ennen siirtoa rajataan henkilötiedot, salaisuudet ja tarpeeton historia. Siirron jälkeen kehitysympäristössä tehdyt data- tai koodimuutokset eivät siirry tuotantoon ilman erillistä julkaisu- tai migraatiovaihetta.

Varmuuskopiointi ja rakenteelliset päivitykset

Kehitysympäristön varmuuskopiointi ei kuulu oletuksena AI Commercen vastuulle. Partneri tai muu tilauksessa nimetty omistaja vastaa tarvittavista varmuuskopioista, säilytysajasta, salauksesta, palautuskokeesta ja mahdollisista ympäristöjen välisistä siirroista. Kehitysympäristöön ei siksi tallenneta ainoaa kappaletta koodista, testiaineistosta tai konfiguraatiosta.

Tuotannon tietokantarakenteen päivitykset voidaan toimittaa automaattisesti molempiin ympäristöihin, vaikka dataa ei synkronoida. Automaattisuus vahvistetaan käyttöönotossa: partnerin pitää tietää päivitysjärjestys, epäonnistumisen vaikutus ja se, voiko kehitysympäristössä oleva keskeneräinen koodi käyttää uutta rakennetta turvallisesti. Rakennepäivityksen onnistuminen ei ole todiste datan tai sovelluskoodin yhteensopivuudesta.

Palautussuunnitelma tehdään ennen ensimmäistä tietokanta- tai infrastruktuurimuutosta. Siinä nimetään palautettava resurssi, palautuksen tekijä, viimeinen hyväksytty varmuuskopio ja testi, jolla palautus todetaan onnistuneeksi. Jos ympäristölle ei ole sovittu varmuuskopiointia, muutos valmistellaan uudelleen luotavaksi koodista ja erillisestä testiaineistosta.

Kehitysympäristön tilaaminen ja konfigurointi

Kehitysympäristö pystytetään AI Commercen toimesta erillisestä pyynnöstä. Ennen tilausta sovitaan ympäristön laajuus, integraatiot, verkkotunnukset, tietokantamalli, jaettavat resurssit, käyttöoikeudet, varmuuskopiointi, alustava aikataulu ja kustannukset. Kehitysympäristöstä peritään pieni kuukausikulu, joka määräytyy ympäristön laajuuden, integraatioiden ja vaatimusten mukaan.

Ympäristön parametreja, kuten kehityspinojen tunnuksia ja tietokantayhteyttä, voidaan hallita asiakkaan käytössä olevassa erillisessä hallintapaneelissa tai GitHubin kauppa-dev-haarassa. Hallintatapa määritetään luovutuksessa. Yleistä AI Commerce -adminia ei pidä olettaa infrastruktuurin provisiointi- tai salaisuushallinnan käyttöliittymäksi ilman asiakkaalle toimitettua nimenomaista polkua ja käyttöoikeutta.

Käyttöönotto on valmis, kun partneri pystyy tunnistamaan ympäristön, julkaisemaan kehityshaaran hyväksytyllä prosessilla, käyttämään testidataa ilman tuotantokirjoituksia ja havaitsemaan virheet. Tuotantotiedon manuaalinen kopiointi tehdään vasta tämän jälkeen. Lopuksi dokumentoidaan, miten ympäristö päivitetään, tyhjennetään, palautetaan ja poistetaan.

Kehitysympäristössä testaaminen ennen tuotantoa

Kehitysympäristössä testaaminen alkaa yhdestä rajatusta muutoksesta, jonka odotettu tulos voidaan havaita ilman tuotantodataa. Varmista ennen testiä selaimen osoite, API-kohde, tietokantayhteys, tallennussäilö, kehityshaara ja käytössä oleva AWS-ympäristö. Keskeytä testi, jos yksikin tunniste osoittaa tuotantoon eikä jaettua resurssia ole nimenomaisesti hyväksytty.

Testaa integraatiosta sekä onnistuminen että epäonnistuminen. Varmista esimerkiksi, että väärä testitunnus ei pääse tuotantopalveluun, kehitysympäristön istunto ei kelpaa tuotantoon ja epäonnistunut julkaisu jättää edellisen version käyttöön. Jos tuotannon kuvavarasto on jaettu vain lukua varten, varmista myös, ettei testi pysty muuttamaan tai poistamaan kuvaa.

Kehitysympäristö täyttää tarkoituksensa vasta, kun hyväksytty muutos voidaan toistaa, katselmoida ja julkaista tuotantoon hallitusti. Kehityksessä tehty commit, tietokantarivi tai asetuskokeilu ei siirry tuotantoon itsestään. Tuotantoonvienti on oma muutos, jolla on hyväksyjä, palautussuunnitelma ja ympäristökohtaiset varmennukset.