0. Docker Desktopin asennus

Asenna Docker Desktop Maciisi ja tarkista moottori, resurssit, tiedostojen jakaminen ja Docker-socket.

Ayakaleaf Pro toimii Dockerin päällä. Macilla käytetään Docker Desktopia, joka ajaa Docker-moottoria Linux-virtuaalikoneessa.

1. Asenna ja käynnistä Docker Desktop

   Asenna Maciisi sopiva Docker Desktop -versio (Apple silicon tai Intel), avaa se ja odota, kunnes moottori on käynnistynyt. Voit käynnistää sen myös Päätteestä:

   open -a Docker
   
2. Tarkista Docker-moottori

   Suorita nämä komennot Päätteessä:

   docker context show
   docker info
   docker compose version
   

   Kontekstin pitäisi osoittaa paikalliseen Docker Desktop -moottoriin, tavallisesti desktop-linux. Jos valittuna on jokin muu konteksti, vaihda Docker Desktopiin ennen kuin jatkat:

   docker context use desktop-linux
   

   Komennon docker info on tulostettava Server-osio. Pelkkä docker --version näyttää vain, että asiakasohjelma on asennettu.

3. Tarkista resurssit ja tiedostojen jakaminen

   Tarkista Docker Desktopin Settings-asetuksista suoritin-, muisti- ja levyrajat sivun Ennen aloittamista mukaisesti sekä tiedostojen jakamisen asetukset, katso Docker Desktopin asetukset.

   Tässä oppaassa Toolkit pidetään hakemistossa /Users, jonka Docker Desktop jakaa oletuksena. Jos käytät muuta sijaintia ja bin/up epäonnistuu virheeseen Mounts denied, lisää kyseinen hakemisto tiedostojen jakamiseen.

4. Tarkista Docker-socket hiekkalaatikkokäännöksiä varten

   Toolkit liittää /var/run/docker.sock-socketin sovellukseen, jotta se voi käynnistää erillisen TeX Live -kontin jokaista käännöstä varten. Pidä DOCKER_SOCKET_PATH=/var/run/docker.sock tiedostossa config/overleaf.rc.

   Macin Docker CLI saattaa muodostaa yhteyden socketin ~/.docker/run/docker.sock kautta. Se on Macin asiakaspäätepiste, eikä se ole syy muuttaa Toolkitin liitoksen lähdettä: kääntäjä tarvitsee moottorin socketin sellaisena kuin Linux-kontit sen näkevät.

   Jos /var/run/docker.sock puuttuu Macilta, ota käyttöön Allow the default Docker socket to be used kohdassa Settings → Advanced, katso Dockerin käyttöoikeusvaatimukset.

   Älä suorita socketille chmod 777 virheiden kiertämiseksi. Pääsy Docker-socketiin vastaa root-oikeuksia Docker-virtuaalikoneeseen.

​

Seuraava vaihe

Kun docker info toimii, jatka vaiheeseen 1. Lataa Toolkit.