CSC – Tieteen tietotekniikan keskus Oy:n sisäisen palveludokumentaation migraation suunnittelu
Pyrrö, Anton (2023)
Julkaisun pysyvä osoite on
https://urn.fi/URN:NBN:fi:amk-2023120534302
https://urn.fi/URN:NBN:fi:amk-2023120534302
Tiivistelmä
Opinnäytetyön aihe oli CSC:n sisäisen palveludokumentaation migraatioon käytettävien työkalujen kartoittaminen ja migraation suunnittelu. Tarve tälle selvitystyölle tuli työharjoittelun aikana CSC:llä. Lähtökohtana oli etsiä ja verrata migraatioon sopivia työkaluja ja ohjelmistoja. Tiedonsiirtoa suunniteltiin Confluencesta GitLabiin, jotta pystyttäisiin vähentämään tiedonsäilytyspaikkoja ja tehostamaan työn tekoa.
Työssä keskityttiin työkalujen kartoittamiseen. CSC:llä oli asetetut kriteerit migraatioon käytettävälle työkalulle. Niitä olivat sisäverkossa tiedon säilyminen, Confluencen sivustorakenteen ja käyttöoikeuksien säilyminen, hyperlinkkien säilyminen ja mahdollisimman monen kosmeettisen ominaisuuden ehjänä pysyminen. Kriteerien nimeämisen jälkeen selvitettiin mahdollisuuksia ja päädyttiin kahteen vaihtoehtoon. Toinen näistä oli Pandoc-niminen ohjelma ja toinen erityisesti Confluencesta Gitlabiin siirtoa varten tehty skripti, joka on julkaistu GitHubiin.
Keskeisenä tuloksena oli migraatiotyökalujen löytäminen ja soveltuvuuden pohdinta. Opinnäytetyön perusteella päädyttiin suosittelemaan Pandoc-ohjelmaa ensisijaisesti. Toissijaiseksi vaihtoehdoksi jätettiin siirtoa varten tehty skripti. Molempia on tarpeen vielä kokeilla ennen lopullista päätöksentekoa. Testaaminen sekä itse siirto rajattiin työn ulkopuolelle ajan puutteen takia.
Johtopäätöksenä todettiin, että tarvitaan lisää tutkimusta ja käytännön kokeilua, mutta työllä luotiin pohja keväällä 2024 tapahtuvalle migraatiolle. Migraation jälkeen palveludokumentaatio käydään läpi ja sisältöä siistitään ja järjestellään niin, että varmistetaan tiedon eheys ja käytettävyys. Migraatio ei ole välttämättä helppo toteuttaa, joten toimeksiantajan tulee varautua ratkaisemaan mahdollisia siirtoon liittyviä haasteita. Työssä opittiin tekemisen aikana raportin kirjoittamista, tietoturvaa, verkostoitumista, ajanhallintaa ja suunnitelman luomista.
Työssä keskityttiin työkalujen kartoittamiseen. CSC:llä oli asetetut kriteerit migraatioon käytettävälle työkalulle. Niitä olivat sisäverkossa tiedon säilyminen, Confluencen sivustorakenteen ja käyttöoikeuksien säilyminen, hyperlinkkien säilyminen ja mahdollisimman monen kosmeettisen ominaisuuden ehjänä pysyminen. Kriteerien nimeämisen jälkeen selvitettiin mahdollisuuksia ja päädyttiin kahteen vaihtoehtoon. Toinen näistä oli Pandoc-niminen ohjelma ja toinen erityisesti Confluencesta Gitlabiin siirtoa varten tehty skripti, joka on julkaistu GitHubiin.
Keskeisenä tuloksena oli migraatiotyökalujen löytäminen ja soveltuvuuden pohdinta. Opinnäytetyön perusteella päädyttiin suosittelemaan Pandoc-ohjelmaa ensisijaisesti. Toissijaiseksi vaihtoehdoksi jätettiin siirtoa varten tehty skripti. Molempia on tarpeen vielä kokeilla ennen lopullista päätöksentekoa. Testaaminen sekä itse siirto rajattiin työn ulkopuolelle ajan puutteen takia.
Johtopäätöksenä todettiin, että tarvitaan lisää tutkimusta ja käytännön kokeilua, mutta työllä luotiin pohja keväällä 2024 tapahtuvalle migraatiolle. Migraation jälkeen palveludokumentaatio käydään läpi ja sisältöä siistitään ja järjestellään niin, että varmistetaan tiedon eheys ja käytettävyys. Migraatio ei ole välttämättä helppo toteuttaa, joten toimeksiantajan tulee varautua ratkaisemaan mahdollisia siirtoon liittyviä haasteita. Työssä opittiin tekemisen aikana raportin kirjoittamista, tietoturvaa, verkostoitumista, ajanhallintaa ja suunnitelman luomista.