Krokin hostaus Managed VPS:llä tarkoittaa, että renderöitte PlantUML-, Mermaid-, GraphViz-, D2-, BPMN- tai Excalidraw-kaavionne koneella, joka on teidän ja jota tiimimme pitävät ajan tasalla ja valvovat yötä päivää. Kroki on MIT-lisenssillä julkaistu avoimen lähdekoodin ohjelma. Tämä opas seuraa sen virallista dokumentaatiota: yhdyskäytävä ja sen apukontit, asennus Docker Composella, konfiguraatio, HTTPS, julkisen instanssin suojaaminen, Asciidoctorin ja MkDocsin liittäminen, varmuuskopiot ja päivitykset.
Kirjoittaja: Simon Vasconcelos Lee
Julkaistu 20. marraskuuta 2026Lukuaika: 14 minuuttia
yuzutech/kroki.KROKI_*_HOST: Docker Compose käynnistää ne yhdessä.SECURE, joka estää sitä lukemasta tiedostoja tai verkkoa; julkisen instanssin käyttöoikeutta hallitaan käänteisessä välityspalvelimessa.compose.yaml ja välityspalvelimen asetukset, ja päivittäkää sitten komennolla docker compose pull luettuanne kunkin version julkaisutiedot.Kroki tarjoaa yhtenäisen HTTP-rajapinnan, joka ottaa vastaan tekstinä kuvatun kaavion ja palauttaa kuvan. Dokumentaationne, wikinne tai koodialustanne lähettää kaavion lähdekoodin; Kroki vastaa SVG-kuvalla ja kaaviotyypin mukaan PNG-, PDF- tai JPEG-kuvalla. Sen README luettelee BlockDiagin, BPMN:n, Bytefieldin, C4:n PlantUML:llä, D2:n, DBML:n, diagrams.netin, Ditaan, Erdin, Excalidraw’n, GoAT:n, GraphVizin, Linin, Mermaidin, Nomnomlin, Pikchrin, PlantUML:n, Svgbobin, Symbolatorin, UMLetin, Vegan, Vega-Liten, WaveDromin ja WireVizin.
/plantuml/svg/SyfFKj2rKt3CoKnELR1Io4ZDoSa70000. Verkkosivu näyttää sen silloin kuten minkä tahansa muun kuvan./graphviz/svg, tai JSON-rungossa.Kroki-Diagram-Options-*.Asciidoctor Kroki -laajennuksen dokumentaatio antaa kolme syytä ajaa omaa palvelinta julkisen kroki.io-instanssin sijaan: yrityksen palomuuri, joka estää sen, viive, kun olette kaukana tästä eurooppalaisesta instanssista, ja luottamuksellisuus, kun kaavioiden lähdekoodin on pysyttävä omassa infrastruktuurissanne.
Kroki julkaistaan MIT-lisenssillä. Se antaa maksutta oikeuden käyttää, kopioida, muokata, yhdistää, julkaista, levittää, alilisensoida ja myydä ohjelmiston kopioita. Voitte siis ajaa sitä yrityksellenne, tiimillenne tai asiakkaillenne ostamatta lisenssiä.
Ainoa ehto on säilyttää tekijänoikeusilmoitus ja lisenssin teksti kaikissa ohjelmiston kopioissa tai sen merkittävissä osissa. Teksti toimittaa ohjelmiston ”sellaisenaan”, ilman takuuta. Krokin mukana tulevilla kaaviokirjastoilla on kullakin oma lisenssinsä.
Krokin arkkitehtuuri on modulaarinen. Javalla Vert.x:n päälle kirjoitettu yhdyskäytävä ottaa vastaan jokaisen pyynnön ja ohjaa sen oikealle kirjastolle. Vain image yuzutech/kroki on pakollinen: dokumentaatio huomauttaa, että se voi kaavioistanne riippuen riittää.
| Image | Mitä se renderöi | Pakollinen |
|---|---|---|
yuzutech/kroki | Yhdyskäytävä sekä ActDiag, BlockDiag, Bytefield, D2, Ditaa, Erd, GoAT, GraphViz, Lini, Nomnoml, NwDiag, PacketDiag, Pikchr, PlantUML ja C4, RackDiag, SeqDiag, Structurizr, Svgbob, Symbolator, UMLet, Vega, Vega-Lite, WaveDrom ja WireViz | Kyllä |
yuzutech/kroki-mermaid | Mermaid: vuokaaviot, sekvenssi- ja Gantt-kaaviot | Ei |
yuzutech/kroki-bpmn | BPMN, bpmn-js:llä | Ei |
yuzutech/kroki-excalidraw | Excalidraw, käsin piirretty tyyli | Ei |
yuzutech/kroki-diagramsnet | diagrams.net, yhä kokeellinen | Ei |
Dokumentaatio ei ilmoita muistin eikä suorittimen tarvetta. Se kertoo kuitenkin, mikä painaa eniten: Mermaidin, BPMN:n, Excalidraw’n ja diagrams.netin apukontit renderöivät jokaisen kaavion Chromium-selaimessa ilman käyttöliittymää. Jotta muunnosten ryöppy ei ylitä kontin muistia, kukin niistä rajoittaa samanaikaisia renderöintejään: oletuksena 6 Mermaidille, BPMN:lle ja diagrams.netille, 4 Excalidraw’lle. Muut pyynnöt odottavat vuoroaan jonossa.
yuzutech/kroki 0.36.0 vie pakattuna noin 1 Gt. Kroki ei kirjoita tietoja: se ei säilytä mitään kahden pyynnön välillä.amd64 ja arm64.depends_on ja KROKI_*_HOST.Managed VPS -palvelimella kertokaa meille kaavioistanne, niiden tarvitsemista apukonteista ja odottamastanne liikenteestä, niin suosittelemme sopivaa kokoa.
Dokumentaatio suosittelee kontteja, Dockeria tai Podmania, jotta kutakin kirjastoa ei tarvitse asentaa käsin. Luokaa palvelimelle, jolle Docker on asennettu, kansio ja tallentakaa siihen tämä dokumentaatiosta otettu compose.yaml:
services:
kroki:
image: yuzutech/kroki:0.36.0
restart: unless-stopped
depends_on:
- mermaid
- bpmn
- excalidraw
environment:
- KROKI_MERMAID_HOST=mermaid
- KROKI_BPMN_HOST=bpmn
- KROKI_EXCALIDRAW_HOST=excalidraw
ports:
- "127.0.0.1:8000:8000"
# If you mount /tmp yourself, keep the exec option
tmpfs:
- /tmp:exec
mermaid:
image: yuzutech/kroki-mermaid:0.36.0
restart: unless-stopped
expose:
- "8002"
bpmn:
image: yuzutech/kroki-bpmn:0.36.0
restart: unless-stopped
expose:
- "8003"
excalidraw:
image: yuzutech/kroki-excalidraw:0.36.0
restart: unless-stopped
expose:
- "8004"
docker compose up -d
127.0.0.1: tämä on ensimmäinen muutos dokumentaation esimerkkiin, joka julkaisee 8000:8000. Kroki kuuntelee oletuksena kaikkia liitäntöjä, ja Docker julkaisee portin kaikkiin palvelimen osoitteisiin, kun osoitetta ei anneta. Tässä rajapintaan pääsee vain käänteisen välityspalvelimen kautta.expose: portti pysyy Composen sisäisessä verkossa, jossa yhdyskäytävä tavoittaa ne palvelun nimellä. Muuttujat KROKI_MERMAID_HOST, KROKI_BPMN_HOST ja KROKI_EXCALIDRAW_HOST antavat tämän nimen; niiden oletusportteja 8002, 8003 ja 8004 ei tarvitse toistaa.0.36.0 on toinen muutos: dokumentaation esimerkki seuraa uusinta versiota. Neljä imagea julkaistaan yhdessä saman tagin alla, joka näin lukitsee yhtenäisen version ja tekee jokaisesta päivityksestä harkitun.Yhä kokeellista diagrams.netiä varten README lisää neljännen apukontin. Lisätkää tämä palvelu sekä muuttuja KROKI_DIAGRAMSNET_HOST=diagramsnet palvelun kroki kohtaan environment:
diagramsnet:
image: yuzutech/kroki-diagramsnet:0.36.0
restart: unless-stopped
expose:
- "8005"
Palvelimelta reitti /health palauttaa yhdyskäytävän tilan ja sen mukana tulevien kirjastojen versiot. Kaksi seuraavaa pyyntöä renderöivät GraphViz-kaavion yhdyskäytävän kautta ja sitten Mermaid-kaavion sen apukontin kautta:
curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/graphviz/svg --data-raw 'digraph G {Hello->World}'
curl http://127.0.0.1:8000/mermaid/svg --data-raw 'graph TD; A-->B'
Dokumentaation toinen tapa on itsenäinen palvelin, joka julkaistaan repositorion julkaisusivulla nimellä kroki-standalone-server-v0.36.0.jar. Se vaatii Java 21:n tai uudemman, eikä siinä ole yhtään kaaviokirjastoa: kukin asennetaan erikseen, ja sen polku annetaan muuttujalla, kuten KROKI_DOT_BIN_PATH, kun ohjelma ei ole polussa PATH. Kuunteluosoitteelle käyttäkää mieluummin muuttujaa KROKI_LISTEN, sillä konfiguraatiodokumentaatio ilmoittaa, että KROKI_PORT poistetaan:
KROKI_LISTEN=127.0.0.1:8000 java -jar kroki-standalone-server-v0.36.0.jar
Krokissa ei ole ylläpitosivua, käyttäjätilejä eikä tietokantaa: sen konfiguraatio koostuu ympäristömuuttujista tai jar-tiedoston kanssa Javan järjestelmäominaisuuksista. Docker Composessa ne kirjoitetaan kyseisen palvelun lohkoon environment, minkä jälkeen docker compose up -d luo kontin uudelleen. Palvelimelle tärkeimmät asetukset:
| Muuttuja | Oletus | Mitä se tekee |
|---|---|---|
KROKI_SAFE_MODE | secure | Suojaustaso, kuvattu alempana |
KROKI_LISTEN | Kaikki liitännät, portti 8000 | Kuunteluosoite ja portti; hyväksyy myös UNIX-socketin, unix:// ja sen perään polku |
KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST | 127.0.0.1 | Mistä yhdyskäytävä tavoittaa kunkin apukontin; vastaavat muuttujat _PORT asettavat portin, ja KROKI_DIAGRAMSNET_HOST palvelee diagrams.netiä |
KROKI_COMMAND_TIMEOUT | 5 sekuntia | Pisin odotusaika kaavio-ohjelmalle, kuten dot |
KROKI_CONVERT_TIMEOUT | 20 sekuntia | Pisin odotusaika Java-kirjastolle, kuten PlantUML |
KROKI_DELEGATE_TIMEOUT_MS | 30 000 | Pisin odotusaika apukontille, millisekunteina |
KROKI_MAX_URI_LENGTH | 4 096 | GET-pyynnössä hyväksytty URL-osoitteen pituus, jonka ylittyessä Kroki vastaa 414 |
KROKI_CONTENT_SECURITY_POLICY | script-src 'none'; object-src 'none' | Otsake Content-Security-Policy, joka lähetetään jokaisen vastauksen mukana |
KROKI_CORS_ALLOWED_HEADERS | Ei lisäotsakkeita | Lisäotsakkeet, jotka sallitaan toiselta sivustolta tuleville kutsuille |
Excalidraw-kaaviot tuottavat pitkiä URL-osoitteita. Jos nostatte arvoa KROKI_MAX_URI_LENGTH, dokumentaatio suosittelee pysymään enintään 8 192 merkissä, vaikka useimmat selaimet hyväksyvät enemmän tagissa <img>. Suurimmille kaavioille POST-pyyntö kuljettaa lähdekoodin rungossa URL-osoitteen sijaan.
Kroki ei tarvitse toimiakseen salaisuutta. Kaksi valinnaista asetusta sisältää sellaisen: tunniste KROKI_COMPANION_REGISTRATION_TOKEN, hyödyllinen, jos otatte käyttöön kolmansien osapuolten apukonttien rekisteröinnin, josta kerrotaan suojaamista käsittelevässä osiossa, sekä varmenteen yksityinen avain, jos annatte Krokin hoitaa HTTPS:n itse. Pitäkää ne erillään kaikista koodirepositorioista.
Yhdyskäytävä tarjoaa rajapintansa HTTP:n kautta. Sen eteen sijoitettu käänteinen välityspalvelin kuuntelee portteja 80 ja 443, hankkii Let’s Encrypt -varmenteen, salaa liikenteen ja välittää sen Krokille osoitteeseen 127.0.0.1:8000. Siellä myös suodatetaan pääsy, kuten seuraava osio näyttää.
Caddy hankkii ja uusii annetun nimen varmenteen itse, ja sen direktiivi reverse_proxy välittää otsakkeet X-Forwarded-For, X-Forwarded-Proto ja X-Forwarded-Host ilman lisäasetuksia:
diagrams.example.com {
encode gzip
reverse_proxy 127.0.0.1:8000
}
Tämä palvelinlohko kuuntelee porttia 80, jotta Certbot voi määrittää HTTPS:n. Kaksi Nginxin rajaa kohtaa Krokin rajat: yli 1 Mt:n pyynnön runko hylätään oletuksena koodilla 413, mitä client_max_body_size säätää POST-pyynnöllä lähetettäville suurille kaavioille; yli 8 kt:n pyyntörivi saa koodin 414, mitä large_client_header_buffers säätää, jos nostatte arvoa KROKI_MAX_URI_LENGTH tätä suuremmaksi.
server {
listen 80;
listen [::]:80;
server_name diagrams.example.com;
client_max_body_size 1m;
location / {
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_pass http://127.0.0.1:8000;
}
}
sudo nginx -t
sudo certbot --nginx
Dokumentaatio kuvaa myös Krokin itse tekemän salauksen: KROKI_SSL=true, varmenne ja yksityinen avain PEM-muodossa, tekstinä muuttujilla KROKI_SSL_CERT ja KROKI_SSL_KEY tai tiedostoina muuttujilla KROKI_SSL_CERT_PATH ja KROKI_SSL_KEY_PATH. Varmenteen uusiminen tehdään silloin käsin, kun taas välityspalvelimen edessä Caddy tai Certbot hoitavat sen itse.
Krokissa ei ole tunnistautumista: kuka tahansa rajapinnan tavoittava voi teettää sillä kaavioita. Sen suojaus perustuu siksi kolmeen asiaan, jotka kuvataan dokumentaatiossa ja julkaisutiedoissa: suojaustilaan, koko- ja aikarajoihin sekä siihen, mitä välityspalvelin päästää läpi. Selvittäkää ensin, kenen täytyy tavoittaa palvelimenne.
kroki-fetch-diagram, MkDocs-lisäosa asetuksella http_method: POST: kuvat tallennetaan sivuston mukana, eikä Kroki-palvelimen tarvitse enää olla julkinen.KROKI_SAFE_MODE määrittää kolme tasoa, joista kukin sisältää edellisen rajoitukset. Dokumentaatio selittää, että jotkin kirjastot voivat lukea tiedostoja tai URL-osoitteita, kuten PlantUML:n direktiivit !include, ja että Kroki, joka ei tarkasta niiden koodia, estää tällaisen pääsyn oletuksena. Se kehottaa jokaista palvelimen ylläpitäjää valitsemaan käyttöönsä sopivan tason.
| Taso | Mitä se tekee |
|---|---|
SECURE, oletus | Estää kaikki yritykset lukea tiedostoja tiedostojärjestelmästä tai resursseja verkosta |
SAFE | Luottaa siihen, että kunkin kirjaston oma turvatila puhdistaa pyynnöt |
UNSAFE | Poistaa kaikki suojaustoiminnot käytöstä |
SECURE sen !include ja !includeurl hylätään, ja sen suojausprofiili on SANDBOX. Tilassa SAFE profiiliksi tulee ALLOWLIST, ja KROKI_PLANTUML_ALLOWLIST_URL tai KROKI_PLANTUML_ALLOWLIST_PATH nimeää, mitä saa sisällyttää.UNSAFE ulkopuolella niiden selain lataa vain paikallisia resursseja. Sisäisen kuvapankin sallimiseksi tilasta poistumatta dokumentaatio tarjoaa muuttujan KROKI_ALLOWED_ORIGINS tai sen apukonttikohtaisen muodon, kuten KROKI_MERMAID_ALLOWED_ORIGINS, apukontin omaan konttiin.UNSAFE: ei !include-direktiiviä Structurizrille, ei ulkoista kuvaa BlockDiagille, ei tiedostojen lukemista Linille.KROKI_STRUCTURIZR_SAFE_MODE tai KROKI_MERMAID_SAFE_MODE, sen sijaan että koko palvelimen tasoa laskettaisiin.Julkisessa instanssissa pitäkää tila SECURE. Versiosta 0.36.0 alkaen oletuksena lähetettävä otsake Content-Security-Policy täydentää tätä suojausta: SVG-kuvaan ujutettu skripti ei suoritu Krokin alkuperässä, ei edes silloin, kun kuva avataan suoraan.
Konfiguraatiotaulukon aikakatkaisut rajaavat jokaisen muunnoksen. Apukontit lisäävät omansa, jotka on suunniteltu resurssien ehtymistä vastaan:
KROKI_MERMAID_MAX_TEXT_SIZE) tai yli 500 reunan lähdekoodin koodilla 400 ja keskeyttää renderöinnin 10 sekunnin jälkeen koodilla 408. Näitä rajoja ei voi ohittaa pyynnön parametreilla.KROKI_MAX_BODY_SIZE).Kun vain julkaisuketjunne kutsuu Krokia, yksinkertaisinta on hyväksyä pelkästään sen IP-osoite. Caddyssä vastinehto remote_ip poimii muut osoitteet, ja respond lähettää niille koodin 403:
diagrams.example.com {
@external not remote_ip 203.0.113.10
respond @external 403
reverse_proxy 127.0.0.1:8000
}
Nginxissä lohkon location direktiivit allow ja deny hoitavat saman tehtävän, ja ensimmäinen täsmäävä sääntö ratkaisee:
allow 203.0.113.10;
deny all;
Välityspalvelimen perustunnistautuminen on toinen tapa: Caddyssä basic_auth, jonka salasana tiivistetään komennolla caddy hash-password, tai Nginxissä auth_basic ja komennolla htpasswd luotu tiedosto. Se sopii asiakasohjelmille, jotka lähettävät tunnukset jokaisen kutsun mukana, kuten curl -u; dokumentaatioketjun kohdalla tarkistakaa, että sen työkalu pystyy välittämään ne. Julkisena pysyvälle instanssille Nginx voi myös rajoittaa pyyntöjen määrää IP-osoitetta kohden moduulillaan limit_req, mitoitettuna sivujenne kaavioiden määrän mukaan.
Kroki voi ottaa vastaan kolmansien osapuolten apukontteja, jotka rekisteröityvät rajapinnan /services kautta. Tämä haku on oletuksena pois päältä ja pysyy aina pois päältä tilassa SECURE. Jos otatte sen käyttöön asetuksella KROKI_ENABLE_COMPANION_DISCOVERY=true, dokumentaatio pyytää pitämään /services-rajapinnan luotetussa verkossa ja suosittelee vahvasti tunnistetta KROKI_COMPANION_REGISTRATION_TOKEN: ilman sitä Kroki varoittaa käynnistyessään, että mikä tahansa yhdyskäytävän asiakas voi rekisteröidä apukontin.
Asciidoctor Kroki ja MkDocs-lisäosa osoittavat oletuksena palvelimeen https://kroki.io. Ne tarvitsevat vain palvelimenne URL-osoitteen etuliitteineen https://.
Asciidoctor Kroki -laajennus lukee määritteen kroki-server-url asiakirjan otsakkeesta, komentoriviltä tai Antoran playbookista. Lisätkää kroki-fetch-diagram, niin kuvat ladataan sivuston koostamisen aikana sen sijaan, että HTML viittaisi palvelimeenne; tämä asetus vaatii Asciidoctorin turvatilaksi server tai sitä matalamman.
:kroki-server-url: https://diagrams.example.com
:kroki-fetch-diagram:
Lisäosa mkdocs-kroki-plugin lukee asetuksen server_url, jonka oletusarvo on ympäristömuuttuja KROKI_SERVER_URL. Asetuksella http_method: POST kuvat tallennetaan koostetun sivuston kunkin sivun viereen ja välimuistitetaan kahden koostamisen välillä:
plugins:
- kroki:
server_url: https://diagrams.example.com
http_method: POST
Dokumentaation kolmansien osapuolten työkaluja käsittelevä sivu mainitsee myös GitLabin, joka renderöi Kroki-kaavioita Markdownissa, AsciiDocissa, reST:ssä ja Textilessä, sekä Sphinxin, Jekyllin, Hugon, Remarkin, Python-Markdownin, MediaWikin, laajennukset Visual Studio Codeen ja IntelliJ:hin sekä Kroki.jl:n Julialle. Mikä tahansa HTTP-asiakas toimii myös, kuten tässä dokumentaation esimerkissä:
curl https://diagrams.example.com/erd/svg --data-binary '@project.erd'
Kroki on tilaton: se ei säilytä mitään kahden pyynnön välillä, ja jopa kolmansien osapuolten apukonttien rekisteri katoaa uudelleenkäynnistyksessä. Kaavioidenne lähdekoodi on dokumentaationne repositorioissa ja niiden kuvat koostetuilla sivustoillanne. Kroki-palvelimelta varmuuskopioidaan sen konfiguraatio:
| Kohde | Mitä se sisältää | Varmuuskopioidaanko |
|---|---|---|
compose.yaml | Imaget, niiden tagit ja muuttujat KROKI_* | Kyllä |
Tiedosto .env, jos sellainen on | Tiedoston compose.yaml ulkopuolella pidettävät muuttujat, kuten tunniste tai varmenne | Kyllä, turvallisessa paikassa |
| Välityspalvelimen konfiguraatio | Caddyfile tai Nginx-lohko sekä salasanatiedosto | Kyllä |
| Docker-imaget | Itse ohjelmisto | Ei: docker compose pull lataa ne uudelleen |
tar -czf kroki-config-$(date +%F).tar.gz compose.yaml /etc/caddy/Caddyfile
Mukauttakaa luettelo välityspalvelimenne mukaan, tehkää uusi kopio jokaisen konfiguraatiomuutoksen jälkeen ja lähettäkää se palvelimen ulkopuolelle. Palvelimen levylle tallennettuna se sisältyy myös sen öisiin varmuuskopioihin. Palautus tarkoittaa näiden tiedostojen palauttamista paikoilleen ja komennon docker compose up -d suorittamista.
Kiinnitettyjä tageja käyttäessänne vaihtakaa neljän imagen versio tiedostossa compose.yaml ja suorittakaa sitten sen kansiossa:
docker compose pull
docker compose up -d
Kroki noudattaa semanttista versiointia, ja jokainen versio julkaisee muutoksensa tiedostossa CHANGELOG.md ja julkaisusivullaan. Lukekaa ne ennen päivitystä, erityisesti niiden osio ”Security”: 5. marraskuuta 2026 julkaistu 0.35.0 ja 9. marraskuuta 2026 julkaistu 0.36.0 korjaavat etäkoodin suorittamisen Bytefield- ja TikZ-kaavioiden kautta, XSS-haavoittuvuudet GoAT:ssa ja DBML:ssä sekä palvelinpuolen pyyntöjen väärentämisen BlockDiagin ja apukonttien kautta. Avoimessa instanssissa ottakaa nämä versiot käyttöön viipymättä.
Versio 0.36.0 lisää myös oletusotsakkeen Content-Security-Policy ja D2:n asettelumoottorin TALA. Manuaalista asennusta varten se dokumentoi vähimmäisversioksi Java 21:n.
Oma hostaus vaatii palvelimen ylläpitoa sovelluksen lisäksi. Managed VPS -palvelimella tiimimme huolehtivat palvelimesta ja seuraavat instanssianne proaktiivisesti; Kroki pysyy teidän ohjelmananne konfiguraatioineen ja apukontteineen.
| Aihe | Tiimimme | Te |
|---|---|---|
| Palvelin | Järjestelmä- ja tietoturvapäivitykset, toimenpiteet palvelimella mukaan lukien | Toimintaanne sopiva ajankohta |
| Valvonta | Palvelinta seurataan ympäri vuorokauden joka päivä, ja puututaan asiaan odottamatta yhteydenottoanne | Instanssinne lokien lukeminen |
| Kroki | Proaktiivinen seuranta: virheet, hitaus, apukonttien muisti ja levytila havaitaan, ja korjausta suositellaan | Sen asennus, päivitykset ja asetukset, jotka toteutatte itse tai tekoälyavustajanne kanssa |
| Kaaviot ja pääsy | Ne renderöivä palvelin, valvottuna ja varmuuskopioituna | Suojaustila, apukontit, rajat ja välityspalvelimen pääsysäännöt |
| Varmuuskopiot | Joka yö, salattuina ja koneen ulkopuolella säilytettyinä; palautus sisältyy | Muualla säilyttämänne konfiguraation kopiot sekä palautuspyyntö, kun tarvitsette sitä |
| Siirto | Nykyinen palvelimenne siirretään, veloituksetta | Käyttöönoton ajankohta |
Jos haluatte tiimiemme toimivan itse sovelluksessa, tämä palvelu laskutetaan tuntiveloituksella tai kiinteällä hinnalla, ja arvio annetaan ennen toimenpidettä.
Simafrin Managed VPS -palvelussa tiimimme pitävät Kroki-instanssinne palvelimen ajan tasalla, valvovat sitä yötä päivää ja toimivat odottamatta yhteydenottoanne; ne seuraavat myös instanssianne proaktiivisesti ja suosittelevat teille hyödyllisiä korjauksia, jotka toteutatte itse tai tekoälyavustajanne kanssa. Varmuuskopiot salataan joka yö ja säilytetään koneen ulkopuolella, niiden palautus sisältyy, ja nykyisen palvelimenne siirto tehdään veloituksetta.
Kyllä. Kroki on MIT-lisenssin alainen: voitte käyttää, muokata ja jakaa sitä edelleen yrityksessä ostamatta lisenssiä, kunhan säilytätte sen tekijänoikeusilmoituksen. Jäljelle jää sitä ajavan palvelimen kustannus.
Vain niiden renderöimiä kaavioita varten. Image yuzutech/kroki riittää PlantUML:lle, GraphVizille, D2:lle, Structurizrille ja useimmille muodoille. Mermaid, BPMN, Excalidraw ja diagrams.net tarvitsevat kukin apukonttinsa, joka liitetään muuttujalla KROKI_MERMAID_HOST, KROKI_BPMN_HOST, KROKI_EXCALIDRAW_HOST tai KROKI_DIAGRAMSNET_HOST.
Luokaa compose.yaml, jossa on image yuzutech/kroki, sen portti 8000 julkaistuna osoitteeseen 127.0.0.1, sekä tarvitsemanne apukontit, kuten yuzutech/kroki-mermaid, liitettyinä muuttujilla KROKI_*_HOST. Suorittakaa docker compose up -d, tarkistakaa /health ja sijoittakaa sitten HTTPS:llä toimiva käänteinen välityspalvelin portin 8000 eteen.
Ei, Krokissa ei ole käyttäjätilejä, ylläpitosivua eikä tietokantaa. Sen konfiguraatio koostuu ympäristömuuttujista KROKI_*, ja rajapinnan käyttöoikeutta hallitaan käänteisessä välityspalvelimessa IP-osoitteen perusteella tai perustunnistautumisella.
Pitäkää oletuksena päällä oleva tila SECURE, joka estää kirjastoja lukemasta tiedostoja tai verkkoa. Jättäkää aika- ja kokorajat paikoilleen, päivittäkää heti, kun versio korjaa haavoittuvuuden, ja jos vain julkaisuketjunne kutsuu Krokia, hyväksykää välityspalvelimessa vain sen osoite.
Asciidoctorissa asettakaa määritteen kroki-server-url arvoksi palvelimenne URL-osoite ja lisätkää kroki-fetch-diagram, jotta kuvat ladataan sivuston koostamisen aikana. MkDocsissa asettakaa server_url kroki-lisäosan konfiguraatioon ja http_method: POST, jotta kuvat tallennetaan sivuston mukana.
Vain sen konfiguraatio: compose.yaml, mahdollinen tiedosto .env ja käänteisen välityspalvelimen konfiguraatio. Kroki ei säilytä tietoja, ja sen Docker-imaget ladataan uudelleen komennolla docker compose pull.
Managed VPS kattaa palvelimen: järjestelmän, tietoturvan, valvonnan ja varmuuskopiot. Tiimimme seuraavat myös instanssianne proaktiivisesti ja suosittelevat hyödyllisiä korjauksia, jotka toteutatte itse. Toimenpide sovelluksessa laskutetaan tuntiveloituksella tai kiinteällä hinnalla.
Simafri
Jutellaan hankkeestasi
Kerro meille muutamalla sanalla, mitä tarvitset: vastaamme sinulle nopeasti.
Kiitos! Pyyntösi on lähetetty. Vastaamme sinulle pian.
Suositko sähköpostia? Kirjoita meille osoitteeseen support@simafri.com.