Päivittäminen Kubernetesissa

Päivitä Ayakaleaf Pron Kubernetes-käyttöönotto yhdellä tai useammalla replikalla.

Päivitys vaihtaa imagen tagin. Uusi versio migroi tietokannan käynnistyessään, ja nämä migraatiot on ajettava kerran, yhdestä podista, kun yksikään vanhempi podi ei ole käynnissä. Kubernetesissa tämä sulkee pois skaalatun StatefulSetin tavallisen rullaavan päivityksen.

Ota yhtenäinen varmuuskopio ennen jokaista päivitystä Ayakaleaf Pron ollessa pysäytettynä. Lue julkaisutiedotteista vaiheet versiolle, johon päivität.

Ennen kuin aloitat, hae komennolla sudo docker pull jokaisella solmulla, joka ajaa Ayakaleaf Prota, kaikki TeX Live -imaget, jotka uusi versio tai uusi konfiguraatiosi listaa.

Yksi replika

1. Pysäytä Ayakaleaf Pro

   kubectl -n overleaf scale deployment/overleaf --replicas=0
   kubectl -n overleaf wait --for=delete pod -l app=overleaf --timeout=5m
   
2. Varmuuskopioi

   MongoDB miltä tahansa jäseneltä:

   kubectl -n overleaf exec mongo-0 -- mongodump --quiet --archive --gzip \
     --uri 'mongodb://mongo-0.mongo:27017,mongo-1.mongo:27017,mongo-2.mongo:27017/sharelatex?replicaSet=overleaf' \
     > sharelatex-$(date +%F).archive.gz
   

   Datataltio lyhytikäisen podin kautta, joka liittää sen (podi päätyy taltion solmulle):

   kubectl -n overleaf run backup --image=busybox --restart=Never --overrides='
   {"spec":{"containers":[{"name":"backup","image":"busybox","command":["sleep","3600"],
    "volumeMounts":[{"name":"d","mountPath":"/data"}]}],
    "volumes":[{"name":"d","persistentVolumeClaim":{"claimName":"overleaf-data"}}]}}'
   kubectl -n overleaf wait --for=condition=Ready pod/backup
   kubectl -n overleaf exec backup -- tar czf - -C /data . > overleaf-data-$(date +%F).tar.gz
   kubectl -n overleaf delete pod backup
   

   Tee sama git-bridgen taltiolle (data-git-bridge-0) ja säilytä kopio Secretistä overleaf-secrets. Jos tallennustilasi tukee VolumeSnapshoteja, taltioiden tilannevedos tekee saman.

3. Vaihda versio ja käynnistä

   Aseta uusi tagi tiedostoon 40-overleaf.yaml (ja tiedostoon 45-git-bridge.yaml, jonka on käytettävä samaa tagia) ja sitten:

   kubectl apply -f 40-overleaf.yaml -f 45-git-bridge.yaml
   kubectl -n overleaf scale deployment/overleaf --replicas=1
   kubectl -n overleaf rollout status deployment/overleaf --timeout=20m
   kubectl -n overleaf logs deployment/overleaf | grep 'Finished migrations'
   

   Deployment käyttää asetusta strategy: Recreate, joten muutettukaan tagi ei koskaan aja kahta versiota samanaikaisesti.

Useita replikoita

Sivun Horisontaalinen skaalaus kokoonpanolle.

1. Pysäytä kaikki replikat

   kubectl -n overleaf scale statefulset/overleaf --replicas=0
   kubectl -n overleaf wait --for=delete pod -l app=overleaf-ha --timeout=10m
   
2. Varmuuskopioi

   MongoDB kuten yhden replikan välilehdellä, S3-bucketit palveluntarjoajasi työkaluilla, git-bridgen taltio (data-git-bridge-0) sekä Secretit. Replikoiden /srv/overleaf-ha sisältää vain käännöstulosteita eikä vaadi varmuuskopiointia.

3. Käynnistä yksi replika uudella versiolla

   Aseta uusi tagi tiedostoihin 70-overleaf.yaml ja 75-git-bridge.yaml sekä replicas: 1:

   kubectl apply -f 70-overleaf.yaml -f 75-git-bridge.yaml
   kubectl -n overleaf rollout status statefulset/overleaf --timeout=20m
   kubectl -n overleaf logs overleaf-0 | grep 'Finished migrations'
   

   Tarkista, että voit kirjautua sisään, avata projektin ja kääntää.

4. Käynnistä muut replikat

   Aseta jälleen replicas: 3 ja ota käyttöön. OrderedReady käynnistää ne yksi toisensa jälkeen.

   kubectl apply -f 70-overleaf.yaml
   kubectl -n overleaf rollout status statefulset/overleaf --timeout=20m
   

Älä vaihda käynnissä olevan skaalatun StatefulSetin imagea komennolla kubectl set image tai kubectl apply: rullaava päivitys käynnistäisi uuden version ja sen migraatiot, kun vanhemmat replikat palvelevat vielä käyttäjiä. Konfiguraatiomuutokset ilman uutta versiota sopivat hyvin rullaavaksi uudelleenkäynnistykseksi: kubectl -n overleaf rollout restart statefulset/overleaf.

​

MongoDB ja Redis

Päivitä ne erikseen Ayakaleaf Prosta. MongoDB:n osalta noudata sivua MongoDB:n päivittäminen (yksi pääversio kerrallaan, featureCompatibilityVersion jokaisen vaiheen jälkeen); replikajoukko ottaa uuden imagen käyttöön jäsen kerrallaan, kun muutat imagea tiedostossa 10-mongo.yaml, koska StatefulSet korvaa vuorollaan mongo-2:n, mongo-1:n ja mongo-0:n.

​

Palauttaminen aiempaan versioon

Pysäytä Ayakaleaf Pro kuten yllä, palauta MongoDB arkistosta (mongorestore --drop --archive --gzip) sekä taltiot tai bucketit varmuuskopiosta, aseta vanha tagi ja käynnistä uudelleen. Uuden version migraatioita ei voi muuten perua.

​

Kysymyksiä ja vastauksia

Replika ei tule valmiiksi, eivätkä muut replikat koskaan käynnisty

Vastaus: Asetuksella podManagementPolicy: OrderedReady overleaf-1 käynnistyy vasta, kun overleaf-0 on valmis, eikä rullaava päivitys korvaa podia, joka ei koskaan tullut valmiiksi. Kun olet korjannut syyn, esimerkiksi virheellisen asetuksen ConfigMapissa, poista jumiutunut podi, jotta StatefulSet luo sen uudelleen nykyisestä mallista:

kubectl -n overleaf delete pod overleaf-0
kubectl -n overleaf rollout status statefulset/overleaf --timeout=20m

Kohtasimme tämän testiklusterillamme, kun asetus esti overleaf-0:aa tulemasta valmiiksi; podin poistaminen antoi kaikkien kolmen replikan käynnistyä.