Siirry pääsisältöön
Tässä osiossa ajamme Ayakaleaf Prota paikallisesti Windowsissa WSL 2:n, Ubuntun, Docker Desktopin ja Ayakaleaf Toolkitin avulla. Opas käyttää osoitetta http://localhost:8080, säilyttää datan Ubuntun kotihakemistossa ja ottaa hiekkalaatikkokäännökset käyttöön. Sovellus, MongoDB, Redis ja TeX Live toimivat Docker Desktopin hallinnoimissa Linux-konteissa. Aja Toolkitin komennot Ubuntussa; avaa sovellus Windows-selaimessasi. Vaihe 0 selittää, miten Windows- ja Linux-osat sopivat yhteen, ja aloittaa WSL:n asentamisesta. Voit käyttää Windowsia paikalliseen instanssiin tai pitää sen jatkuvasti käynnissä vaiheen 6 saatavuusasetuksilla. Jaetuille ja tuotantopalvelimille suosittelemme Linux-opasta HTTPS:n, varmuuskopioiden ja käyttöoikeuksien hallinnan kanssa. Windowsin lepotila, Docker Desktopin sammutus ja WSL:n sammutus keskeyttävät tämän paikallisen instanssin; katso Pidä instanssi saatavilla.

Ennen aloittamista

Tarvitset:
  • Windows-version ja suorittimen, joita Docker Desktop for Windows tukee, ja laitteistovirtualisoinnin käyttöön otettuna. Tämä opas käyttää Windows 11:tä x86-64-arkkitehtuurilla.
  • Oikeudet ottaa WSL käyttöön ja asentaa ohjelmistoja. WSL:n on oltava versio 2.1.5 tai uudempi, ja Ubuntun on toimittava WSL 2 -tilassa.
  • Riittävästi muistia Windowsille ja konteille. Pientä paikallista instanssia varten Dockerin käytettävissä olevat 4 suoritinta ja 8 Gt ovat suositeltu lähtökohta, eivät mitattu vähimmäisvaatimus.
  • Vapaata tallennustilaa Windows-levyllä, jolla WSL:n ja Dockerin data on. Varaa vähintään 40 Gt täydelle TeX Live -kokoonpanolle sekä projektidatalle; vaiheen 5 basic-image on pienempi ja sopii ensimmäiseen käyttöönottotestiin. Lisäimageversiot tarvitsevat lisää tilaa.
  • Verkkoyhteyden GitHubiin, GitHub Container Registryyn (ghcr.io) ja Docker Hubiin Toolkitin kloonaamista ja imagejen lataamista varten.
PowerShell-lohkot ajetaan Windowsissa. Bash-lohkot ja bin/-komennot ajetaan Ubuntussa, ellei toisin mainita. Älä aja Toolkitin skriptejä PowerShellissä tai Windowsin Git Bashissa.

Vaiheet

0. WSL 2:n ja Docker Desktopin asennus

1. Lataa Toolkit

2. Tutustu Toolkitiin

3. Alusta konfiguraatio

4. Hanki Ayakaleaf Pro -imaget

5. Instanssin mukauttaminen

6. Asennuksen jälkeiset tehtävät

Viimeksi muokattu 8. marraskuuta 2026