Vscode-python

Vscode-python er en tjeneste på Dapla Lab for utvikling av kode i Python¹. Målgruppen for tjenesten er brukere som skal skrive produksjonskode i Python.

Siden tjenesten er ment for produksjonskode så er det veldig få forhåndsinstallerte Python-pakker som er installert. Antagelsen er at brukerene/teamet heller bør installere de pakkene de trenger, framfor at alle pakker som alle brukere/team er forhåndsinstallert og skal dekke behovet til alle. Det reduserer kompleksitet i tjenesten og dermed sannsynligheten for feilsituasjoner.

Forberedelser

Før man starter Vscode-python bør man ha lest kapitlet om Dapla Lab og satt opp Git- og GitHub-konfigurasjonen under Min konto. Deretter gjør du følgende:

1. Logg deg inn på Dapla Lab
2. Under Tjenestekatalog trykker du på Start-knappen for Vscode-python
3. Gi tjenesten et navn
4. Åpne Vscode-python konfigurasjoner

Konfigurasjon

Konfigurasjonen av VSCode er nær identisk Jupyter-tjenesten sin konfigurasjon. Se dokumentasjonen for konfigurasjon av Jupyter.

Datatilgang

Slik kan man inspisere dataene fra en terminal inne i tjenesten:

1. Åpne en instans av Vscode-python med data fra bøtter
2. Åpne en terminal inne i Vscode-python
3. Gå til mappen med bøttene ved å kjøre dette fra terminalen cd /buckets
4. Kjør ls -ahl i teminalen for å se på hvilke bøtter som er montert.

Installere pakker

Siden det nesten ikke er installert noen pakker i tjenesten så kan brukeren opprette et ssb-project og installere pakker som vanlig.

For å bygge et eksisterende ssb-project så kan brukeren også bruke ssb-project.

Slette tjenesten

For å slette tjenesten kan man trykke på Slette-knappen i Dapla Lab under Mine tjenester. Når man sletter en tjeneste så sletter man hele disken inne i tjenesten og frigjør alle ressurser som er reservert. Siden pakkene som er installert også ligger lagret på disken, betyr dette at pakkene må installeres på nytt etter at en tjeneste er slettet. Vi anbefaler at man avslutter heller pauser tjenester som ikke benyttes.

Pause tjenesten

Man kan pause tjenesten ved å trykke på Pause-knappen i Dapla Lab under Mine tjenester. Når man pauser så slettes alt påden lokale disken som ikke er lagret under $HOME/work. Vi anbefaler at man avslutter heller pauser tjenester som ikke benyttes.

Monitorering

Man kan moniterere en instans av Vscode-python ved å trykke på Vscode-python-teksten under Mine tjenester i Dapla Lab, slik som vist i Figur 1.

Figur 1: Monitorering av Jupyter-tjenesten i Dapla Lab

Extensions

VSCode følger med et sett med extensions ferdig installert. Disse kan per nå ikke installeres av brukeren selv.

Jupytext

Jupytext-filer kan jobbes med som notebooks i Jupyter. For å gjøre dette, må man legge til Jupytext som en Python-avhengighet i ditt Python-prosjekt:

poetry add --group dev "jupytext >=1"

..og deretter velge din pakkes Python-versjon som å være interpreter. Dette gjør man ved å trykke på den røde boksen på bildet, og velge interpreteren på filstien <PAKKENAVN>/.venv/bin/python.

Figur 2: Monitorering av Jupyter-tjenesten i Dapla Lab

Deretter kan man høyreklikke på filen og trykke “Open as Jupyter Notebook”.

Figur 3: Konfigurasjon av Git for Jupyter-tjenesten i Dapla Lab

Fotnoter

1. Vscode-python er web-versjonen av VS Code og er ikke helt identisk med desktop-versjonen av VS Code mange er kjent med. Blant annet er det kun extensions fra Open VSX Registry som kan installeres.