AP221 Use Case TUL Migrer og produksjonssett tjenesteutgave

Transkript

1 AP221 Use Case TUL Migrer og tjenesteutgave

2 Migrer og tjenesteutgave Ved migrering av tjeneste overføres en utgave av tjenesten til et sluttbrukermiljø. For test kan migrering gjøres fullt og helt av tjenesteutvikler i tjenesteutviklingsløsningen. Dette beskrives i use case Migrer tjenesteutgave til test under. En annen variant av migrering av tjeneste er migrering til produksjon. Her er det applikasjonsforvalter v/driftsleverandør som gjennomfører migreringen. En tjenesteutvikler har ikke tilgang til å e en tjenesteutgave. Produksjonssetting og publisering til tjenestekatalogen beskrives i use caset Produksjonssett tjenesteutgave under. Hvilke fagsystem/etat som har tilgang til hvilke portalmiljøer vedlikeholdes på en egen side i Tjenesteutviklingsløsningen, Tilgangsstyring portalmiljøer (se site map TUL). Tilbakerulling av en utgave i et sluttbrukermiljø til en tidligere versjon løses på tilsvarende måte som migrering, hvor man endrer nåværende versjon til å være ugyldig og gjenoppretter gyldigheten på en tidligere versjon, Dette omhandles i use casene Rull tilbake versjon av utgave i test og Rull tilbake versjon av utgave i produksjon under. Som tjenestekatalog benyttes den eksisterende funksjonaliteten i InfoPortalen (EPiServer). Ved publisering av tjenester til produksjon og test må det gjøres manuelle oppdateringer her, og tjenesten må legges inn med nødvendige parametere. Det vil være noen parametere som må legges inn både i Tjenesteutviklingsløsningen og på InfoPortalen (EPiServer). Dette gjelder tjenestenavn,, tjenesteeier og gyldighetsdato. For test er det ikke nødvendig å legge inn disse parameterne for å teste selve tjenesten, siden disse er ment for kategorisering. Ytterligere beskrivelse kommer i de underliggende use casene. Migrering av formidlingstjenester vil foregå ved bruk av Microsoft BizTalk som vil være tilgjengelig på Citrix arbeidsflaten for tjenesteutviklingsløsningen. Formidlingstjenester vil ikke beskrives ytterligere i use caset. Dokumentet er delt inn i disse fire use casene: Migrer tjenesteutgave til test Produksjonssett tjenesteutgave Rull tilbake versjon av utgave i test Rull tilbake versjon av utgave i produksjon 2/13

3 Migrer tjenesteutgave til test En tjeneste kan i sin helhet migreres til et testmiljø av tjenesteutvikler. Den må også legges inn i InfoPortalen (EpiServer) på det aktuelle testmiljøet. En link til InfoPortalen (EpiServer) vil ligge på kvitteringssiden ved migrering. Det vil også ligge linker til EpiServer for de forskjellige testmiljøene tilgjengelig på Citrix-arbeidsflaten. Fagperson Start migrering Velg miljø Velg systemtest Velg akseptansetest Velg migreringsalternativer TUL Sammenstill og migrer tjenesteutgave Generer versjonrapport Oppdater migreringsstatus Figur 1 - Migrer tjenesteutgave til test Aktør(er) Trigger Pre-betingelser Migrer tjenesteutgave til test Fagperson En ny tjenesteutgave skal migreres til et sluttbrukermiljø En ny versjon av en utgave skal migreres til et sluttbrukermiljø Bruker er logget inn i Tjenesteutviklingsløsningen (Se use case Logg inn ). 3/13

4 Post-betingelser Normal utføring Migrer tjenesteutgave til test Bruker har rettigheter til å migrere til systemtest- og akseptansetestmiljø. Bruker har navigert til riktig tjeneste og utgave (Se use case Finn tjeneste og utgave ) og valgt denne. Bruker står på arbeidsflate for utgaven. Tjeneste er ferdig utviklet med alle påkrevde metadata og komponenter. Eventuell kodeliste må være migrert til testmiljøet Utgave er migrert til ønsket sluttbrukermiljø Utgave er klar til testing i ønsket sluttbrukermiljø Se Figur 1 - Migrer tjenesteutgave til test 1) Start migrering: Tjenesteutvikler starter migrering av valgt utgave fra Tjenesteutviklingsløsningen 2) Velg miljø: Velg blant tilgjengelige instanser innenfor testmiljøene under: 1 eller flere instanser kan velges. Listen er ikke uttømmende. a) Systemtest b) Akseptansetest 3) Velg migreringsalternativer: Her velges for eksempel a) hvilke språkversjoner som skal migreres. Alle språkversjoner er valgt som standard, men enkeltspråk kan velges bort. Se Feilhåndtering: Feil i språkversjoner for håndtering av delvis oversatte språk. b) Konfigurer testdato (justering av gyldighetstdato for tjeneste. Overstyrer gyldighetsdato definert i selve tjenesten) 4) Sammenstill og migrer tjenesteutgave: Når migrering igangsettes, startes en eksportjobb som pakker sammen tjenestekomponentene til en pakke, versjonerer den og overfører den til valgt sluttbrukermiljø. Sluttbrukermiljøet oppdateres med ny versjon av utgaven. Full tjenesteutgave inneholder referanser til metadataversjon og dokumentversjoner. 5) Generer versjonsrapport: Rapport for den ny versjonen genereres og tilgjengeliggjøres. (Rapporten for informasjon om innhold i valgt versjon, kan blant annet brukes ved tilbakerulling) 6) Oppdater migreringsstatus: Tjeneste overført til testmiljø valgt i punkt 2 Alternativ utføring Feilhåndtering Etter endt vellykket migrering vil man kunne finne tjenesten i valgt sluttbrukerløsning. En lenke til tjenesten vil bli presentert for bruker i TUL. Generell feil i migrering Feil oppstår i punkt 4) Sammenstill og migrer. 1) Migrering avbrytes a. Feil i sammenstilling -> Avbryt og send varsel b. Feil i migrering -> Dersom miljø er endret, rull tilbake, send varsel Feil i språkversjoner Tjenesteutgaven som skal migreres har en språkversjon som er bare delvis oversatt (for versjon 1 gjelder dette oversatte parametere, ikke skjemadelen. Se use case Oversett tjenesteutgave ). 1) Normal utføring 1) 3) som vanlig 2) Feil oppstår i punkt 4) Sammenstill og migrer 3) Advarsel gis Språkutgave X av tjenesteutgave er ikke komplett. a. Stopp migrering av Språkutgave X b. Fortsett migrering av Språkutgave X. Hovedspråk vil legges inn der oversetting mangler 4/13

5 Migrer tjenesteutgave til test 4) Normal utføring 4-5 Forretningsregler Tjenesteutvikler skal kunne overføre ferdigutviklede tjenester fra TUL til testmiljø Referanse til use Logg inn case o AP221 Use Case - TUL Logg inn.doc Finn tjeneste og utgave o AP221 Use Case - TUL Finn tjeneste og utgave.doc Site Map TUL o AP342 Site Map TUL.ppt Referanse til krav TUL_ Alle disse tjenesteutviklingsmiljøene kan migrere tjenester til et sett av tilhørende sluttbrukerløsninger - herunder for utføring av f.eks. systemtest, akseptansetest og ing. TUL_ Hvert miljø for tjenesteutvikling inneholder en oversikt over det sett av sluttbrukerløsninger det kan migreres tjenester til. TUL_ Når en ny utgave av tjenesten er ferdig utviklet og enhetstestet kan tjenesteutvikler migrere utgaven til et eller flere tilhørende sluttbrukermiljøer. TUL_ Det normale ved utvikling vil være at man suksessivt migrerer til systemtest, akseptansetest og videre frem mot produksjon, men det er også mulig å hoppe over forutgående migreringer (eksempelvis gå direkte fra enhetstest til akseptansetest). TUL_ Det er mulig å kun migrere de egenskaper og beskrivelser som er definert om utgaven av tjenesten. TUL_ Dersom det finnes flere utgaver av en tjeneste, kan disse migreres uavhengig av hverandre. TUL_ Migrering av tjeneste fra enhetstest til systemtest og videre til akseptansetest kan i sin helhet gjøres av tjenesteutvikler hos tjenesteeier. TUL_ Det er mulig å migrere en meldingstjeneste til de forskjellige sluttbrukermiljøene for test. TUL_ Det er mulig å teste hendelser som er tidsstyrte for en tjeneste. TUL_ Det er mulig å migrere en innsynstjeneste til de forskjellige sluttbrukermiljøene for test og produksjon. TUL_ Det er mulig å migrere til valgfri sluttbrukerløsning. TUL_ Migreringsstatusen skal være tilgjengelig for tjenesteutvikler uten å måtte involvere applikasjonsforvalter. TUL_ Tjenesteutviklingsløsningen kan kontrollere at innsendingstjenesten er fullstendig før den migreres til en sluttbrukerløsning. TUL_ Det er mulig å sette opp en meldingstjeneste med forskjellige egenskaper i forskjellige sluttbrukermiljøer. For eksempel skal det være mulig i systemtestmiljøet å sette opp tjenesten til å hente meldinger fra en maskin hos tjenesteeier, mens det i akseptansetest kan benyttes en annen maskin. Krav dekket i TUL_ Hvis ikke tjenesteutvikler har lagret utgaven som en helhet og fått den versjonert utføres dette automatisk før migrering finner sted. design TUL_ Migrering fører ikke til nedetid i portalen. TUL_ All migrering av nye eller reviderte tjenester kan gjøres uten behov for nedetid i sluttbrukerløsningen. TUL_ All migrering til en sluttbrukerløsning gir minimalt med nedetid, og en eksisterende versjon som skal overskrives fungerer som normalt helt frem til det øyeblikk den nye versjonen er ferdig migrert og skal ta over for den gamle versjonen. 5/13

6 Produksjonssett tjenesteutgave Utgaven es og tilgjengeliggjøres for sluttbrukerløsningen. Selve ingen skjer når tjenesten er kvalitetssikret i akseptansetest eller på annen måte er klargjort for ing. Publisering av tjenesteutgave i Tjenestekatalog Use caset Produksjonssett tjenesteutgave handler om å produksjonsette tjenesten fra Tjenesteutviklingsløsningen til Sluttbrukerløsningen. I tillegg til dette må det gjøres endringer på Infoportalen i forbindelse med publisering av nye tjenester. Det gjøres av fagperson/tjenesteutvikler med redaktørrettigheter på Infoportalen. Eksempler på dette kan være: - Legge inn og kategorisere ny tjeneste i Tjenestekatalogen - Legge til hjelpeside med f.eks. brukerstøtte, innsendingsfrist, spesielle regler, tips, etc om tjeneste (kan også være felles for flere tjenester) - Legge til eventelt andre sider som kan lenkes til fra tjeneste/skjema - Tjenestekatalogen faller utenfor scope for dette use caset og oppdatering her er en egen prosess som gjøres hos etat/asf. Arbeidet med å legge inn en ny tjeneste i InfoPortalen kan påbegynnes så snart en tjeneste er besluttet opprettet, men selve innleggingen med dyplenke til den faktiske tjenesten gjøres først når tjenesten er ferdig og migrert til Sluttbrukerløsningen. Eksisterende tjenester vil ligge uendret på InfoPortalen og fortsatt omfattes av tidligere kategorisering. Varsling Ved endringer i produksjon må involverte parter varsles. Det må defineres hva slags varslinger som skal sendes automatisk, og til hvem. Andre varsler, som til sluttbrukersystemene må også defineres, enten det blir manuelle eller automatiske rutiner. 6/13

7 Fagperson Start migrering Velg blant tilgjengelige versjoner Velg migreringsalternativer TUL Sammenstill og eksporter tjenesteutgave Oppdater migreringsstatus Applikasjonsforvalter v/driftsleverandør Oppdater produksjonsmiljø Rapporter/varsler Figur 2 - Produksjonssett tjenesteutgave Aktør(er) Trigger Pre-betingelser Post-betingelser Produksjonssett tjenesteutgave Fagperson Applikasjonsforvalter v/driftsleverandør Produksjonssetting av ny utgave eller versjon av utgave er bestilt (egen prosess hos ASF/tjenesteeier) Bruker er logget inn i Tjenesteutviklingsløsningen (Se use case Logg inn ) Bruker har navigert til riktig tjeneste og utgave (Se use case Finn tjeneste og utgave ) og valgt denne. Bruker står på arbeidsflate for utgaven. Tjenesten er kvalitetskontrollert av applikasjonsforvalter Bruker har rettigheter til å e tjeneste. En ny tjeneste er godkjent av tjenesteeier (egen prosess hos ASF/tjenesteeier) Riktig kodeliste må være migrert til produksjon Tjeneste og/eller tjenesteutgave er produksjonssatt i sluttbrukerløsningen og tilgjengeliggjort for sluttbrukersystemene 7/13

8 Normal utføring Alternativ utføring Feilhåndtering Produksjonssett tjenesteutgave Det har blitt rapportert/varslet hva som er produksjonssatt og status Se Figur 2 - Produksjonssett tjenesteutgave 1. Start migrering: Tjenesteutvikler starter migrering fra Tjenesteutviklingsløsningen 2. Velg blant tilgjengelige versjoner: Med versjon menes en arbeidsversjon av en utgave som er migrert til et testmiljø, i og med at forskjellige versjoner av samme utgave kan være migrert til forskjellige testmiljøer. En tjeneste må være pakket og korrekt installert i et testmiljø før den kan velges for migrering til produksjon. 3. Velg migreringsalternativer: Bekreft start av migrering med valgte parametere. Her velges for eksempel hvilke språkversjoner som skal migreres. Alle språkversjoner er valgt som standard, men enkeltspråk kan velges bort. Se Feilhåndtering: Feil i språkversjoner for håndtering av delvis oversatte språk. 4. Sammenstill og eksporter tjenesteutgave: Det startes en eksportjobb som henter valgt pakke og kontrollerere den for ing. En prosess for å overføre til produksjonsmiljø startes (denne prosessen er ikke definert). 5. Oppdater migreringsstatus: Status tilsvarende Bestilt ing settes i TUL 6. Oppdater produksjonsmiljø: produksjonsmiljøet oppdateres med ny utgave/versjon eller metadata. Dette er en egen prosess som gjøres utenom TUL. 7. Rapporter/varsler: Nødvendige rapporter og varsler sendes involverte aktører med beskjed om hva som er produksjonssatt og status. Generell feil i migrering Feil oppstår i punkt 6) Oppdater produksjonsmiljø. 1) Migrering avbrytes: Manuelt eller automatisk 2) Produksjonsmiljøet tilbakestilles hvis endringer er gjort Feil i språkversjoner Tjenesteutgaven som skal migreres har en språkversjon som er bare delvis oversatt 1) Normal utføring 1) 3) som vanlig 2) Migrering stopper Språkutgave X av tjenesteutgave er ikke komplett, migrering av språkutgave kan ikke fortsette Forretningsregler Ferdig utviklede tjenester skal kunne es Referanse til krav TUL_ Det er et overordnet prinsipp at man kan velge å e utvalgte eller alle deler fra utviklingsprosessen når man migrerer skjema til sluttbrukerløsning fra tjenesteutviklingsløsningen. Gjelder innsendingstjeneste TUL_ I dette ligger det også at det er enkelt å e endringer i definisjonen. INT_ Det er mulig å overføre nødvendig informasjon fra tjenesteutviklingsløsningen til tjenesteoversikten/tjenestekatalogen i sluttbrukerløsningen, spesielt må kategoriene oppdateres basert på hva som er definert om sluttbrukertjenestene og kategoriseringen av disse. Leverandøren må beskrive hvorvidt dette kan gjøres på en tjenesteorientert måte. INT_ Den nye tjenesteutviklingsløsningen kan definere opp de eksisterende sluttbrukertjenestene til bruk i kategorisering av sluttbrukertjenester. Med definering menes her å beskrive egenskaper om tjenestene som navn, språk, til-fra dato, osv samt en kobling til en konkret tjeneste i den eksisterende tjenesteutviklingsløsningen. Krav dekket i design TUL_ Ved ing er det bl.a. mulig å angi tidspunktet for når den atomære overgangen fra en gammel versjon til den nye skal finne sted, dvs. at man kan kjøre migrering på et tidligere tidspunkt, verifisere at det gikk bra og så inntreffer overgangen på et senere tidspunkt. 8/13

9 Produksjonssett tjenesteutgave INT_ EPiServer kan videreføres som portal-/publiseringsverktøy i tjenesteutviklingsløsningen i Altinn. TUL_ Migrering fører ikke til nedetid i portalen. TUL_ All migrering av nye eller reviderte tjenester kan gjøres uten behov for nedetid i sluttbrukerløsningen. TUL_ All migrering til en sluttbrukerløsning gir minimalt med nedetid, og en eksisterende versjon som skal overskrives fungerer som normalt helt frem til det øyeblikk den nye versjonen er ferdig migrert og skal ta over for den gamle versjonen. 9/13

10 Rull tilbake versjon av utgave i test Dette use caset omhandler tilbakerulling av versjon av utgave i test. Test og produksjon er veldig like med unntak av aktør og oppdatering av miljø. Tilbakerulling vil si å aktivere en tidligere versjon av en utgave, og den nye versjonen deaktiveres. Tilbakerulling av utgaver initieres fra Tjenesteutviklingsløsningen og utføres i Sluttbrukerløsningen. Tilbakerulling gjøres i Sluttbrukerløsningen, ikke i Tjenesteutviklingsløsningen. Arbeidsflaten for en utgave i TUL vil ikke endres. Derimot vil det i TUL tilgjengeliggjøres en rapport ved sammenstilling og migrering av en versjon av utgaven. Innholdet i denne rapporten er versjonsnummeret for alle filer og alle parameterverdier. Med parameterverdier menes de parameterne som er lagt inn via egne sider i utgavearbeidsflaten og ikke håndteres av filhåndteringen i SharePoint. Skal en utgave rulles tilbake til en tidligere versjon i TUL må dette gjøres manuelt basert på denne rapporten. Fagperson Start tilbakerulling Velg miljø Velg blant tilgjengelige versjoner TUL Endre gyldighetsdato Oppdater migreringsstatus Sluttbrukermiljø Rull tilbake Figur 3 - Rull tilbake versjon av utgave Aktør(er) Trigger Pre-betingelser Rull tilbake versjon av utgave i test Fagperson En tjenesteutgave skal rulles tilbake i et miljø (til en annen versjon) Bruker er logget inn i Tjenesteutviklingsløsningen (Se use case Logg inn ). 10/13

11 Post-betingelser Normal utføring Rull tilbake versjon av utgave i test Bruker har rettigheter til å rulle tilbake versjon (ref aktører og hva de har rettigheter til) Bruker har navigert til riktig tjeneste og utgave (Se use case Finn tjeneste og utgave ) og valgt denne. Bruker står på arbeidsflate for utgaven. Ønsket versjon av utgave bruker skal rulle tilbake til ligger allerede i det valgte sluttbrukermiljøet Tjenesteutgave er rullet tilbake til ønsket versjon Se Figur 3 - Rull tilbake versjon av utgave Alternativ utføring Feilhåndtering Forretningsregler Referanse til use case 1) Start tilbakerulling: Bruker starter tilbakerulling av valgt versjon av utgave fra Tjenesteutviklingsløsningen. Det er den gjeldende versjonen som ligger i sluttbrukerløsningen som kommer til å rulles tilbake 2) Velg miljø: Velg blant tilgjengelige instanser innenfor testmiljøene eller produksjon, avhengig av brukers rettigheter 3) Velg blant tilgjengelige versjoner: Med versjon menes en arbeidsversjon av en utgave. Kun én aktiv versjon finnes av hver utgave i sluttbrukerløsningen, men de tidligere migrerte versjonene ligger lagret. Tjenesteutviklingsløsningen har tilgang til alle versjonene og status over hvilket miljø de er migrert til. Kun versjoner som tidligere er migrert til gjeldende miljø vil kunne velges her. 4) Endre gyldighetsdato: Tilbakerulling vil i praksis bety å endre gyldighetsdato på versjonene. Gjeldende versjon deaktiveres, og gammel versjon aktiveres. Datoene vil være konfigurerbare, med default-verdi. 5) Oppdater migreringsstatus. Det vil kun være en migreringsstatus pr. utgave pr. miljø. 6) Rull tilbake: Den faktiske endringen foretas i gjeldende miljø. Overgangen fra Tjenesteutviklingsløsningen Testmiljø blir som i use case Migrer tjenesteutgave til test Feil oppstår i punkt 6) Rull tilbake 1) Migrering avbrytes a. Feil i sammenstilling -> Avbryt og send varsel b. Feil i migrering -> Dersom miljø er endret, rull tilbake, send varsel Logg inn o AP221 Use Case - TUL Logg inn.doc Finn tjeneste og utgave o AP221 Use Case - TUL Finn tjeneste og utgave.doc Referanse til krav TUL_ Det er mulig å passivisere en versjon av en utgave i et sluttbrukermiljø og aktivere en tidligere versjon. TUL_ Det er mulig å rulle tilbake utgaven til et tidligere versjonsnummer. Krav dekket i design Rull tilbake versjon av utgave i produksjon Se beskrivelse under Rull tilbake versjon av utgave i test. Aktør(er) Rull tilbake versjon av utgave i produksjon Tjenesteutvikler 11/13

12 Trigger Pre-betingelser Post-betingelser Normal utføring Rull tilbake versjon av utgave i produksjon En tjenesteutgave skal rulles tilbake i produksjon (til en annen versjon) Bruker er logget inn i Tjenesteutviklingsløsningen (Se use case Logg inn ). Bruker har rettigheter til å rulle tilbake versjon (ref aktører og hva de har rettigheter til) Bruker har navigert til riktig tjeneste og utgave (Se use case Finn tjeneste og utgave ) og valgt denne. Bruker står på arbeidsflate for utgaven. Ønsket versjon av utgave bruker skal rulle tilbake til ligger allerede i det valgte miljøet Tjenesteutgave er rullet tilbake til ønsket versjon Se Figur 3 - Rull tilbake versjon av utgave Alternativ utføring Feilhåndtering Forretningsregler Referanse til use case 1) Start tilbakerulling: Tjenesteutvikler starter tilbakerulling av valgt versjon av utgave fra Tjenesteutviklingsløsningen. Det er den gjeldende versjonen som ligger i sluttbrukerløsningen som kommer til å rulles tilbake 2) Velg miljø: Velg blant tilgjengelige instanser innenfor testmiljøene eller produksjon, avhengig av brukers rettigheter 3) Velg blant tilgjengelige versjoner: Med versjon menes en arbeidsversjon av en utgave. Kun én aktiv versjon finnes av hver utgave i sluttbrukerløsningen, men de tidligere migrerte versjonene ligger i arkiv. Tjenesteutviklingsløsningen har tilgang til alle versjonene og status over hvilket miljø de er migrert til. Kun versjoner som tidligere er migrert til gjeldende miljø vil kunne velges her. 4) Endre gyldighetsdato: Tilbakerulling vil i praksis bety å endre gyldighetsdato på versjonene. Gjeldende versjon deaktiveres, og gammel versjon aktiveres. Datoene vil være konfigurerbare, med default-verdi. 5) Oppdater migreringsstatus: for eksempel Tilbakerulling bestilt for produksjon. Hvilke statuser som vil være tilgjengelige her, konkretiseres i design. 6) Rull tilbake: Den faktiske endringen foretas i gjeldende miljø. Overgangen Tjenesteutviklingsløsningen Produksjon i use case Produksjonssett tjenesteutgave, gjøres av Applikasjonsforvalter v/driftsleverandør. Feil oppstår i punkt 6) Rull tilbake 1) Migrering avbrytes a. Feil i sammenstilling -> Avbryt og send varsel b. Feil i migrering -> Dersom miljø er endret, rull tilbake, send varsel Logg inn o AP221 Use Case - TUL Logg inn.doc Finn tjeneste og utgave o AP221 Use Case - TUL Finn tjeneste og utgave.doc Referanse til krav TUL_ Det er mulig å passivisere en versjon av en utgave i et sluttbrukermiljø og aktivere en tidligere versjon. TUL_ Det er mulig å rulle tilbake utgaven til et tidligere versjonsnummer. Krav dekket i design 12/13

13 Relatert dokumentasjon Dokument Type Kommentar AP353 Sub-component Design definition TUL Service Edition AP347 Page Specification Design High Level - TUL Migrate Package AP311 Service Definition High Level TUL Migrate Package Design 13/13