Komme i gang

For å nå din Knast må du ha naisdevice.

For å opprette en personlig Knast åpner du Datamarkedsplassen, logger inn og går til "Min Knast" i hamburgermenyen. Der vil du få opp en dialog som tar deg gjennom oppsettet første gang. Alle valg kan endres også etter at Knasten er opprettet.

Dette må du velge¶

Maskintype¶

Du vet best hvor stor maskin du trenger. Husk at store maskiner er dyrere i drift. Så hvis du er usikker er det lurt å starte smått.

Utviklingsmiljø¶

Hvilken IDE vil du jobbe i? Nada tilbyr noen standardimages, men det er mulig å lage custom images i https://github.com/navikt/knast-images.

Onprem-kilder (valgfritt)¶

Hvilke onprem-kilder har du behov for å snakke med? Her kan du også velge nais-ingresser som "intern.nav.no", hvis du skal åpne mot f.eks https://teamkatalogen.intern.nav.no

Internett-URLer (valgfritt)¶

Her legger du til URL-stier som du trenger å snakke med på internett. Det er god praksis å åpne for minst mulig, for eksempel er github.com/navikt/* bedre enn github.com/*. Les mer om syntax her.

Sentralt administrerte åpninger¶

Nada vedlikeholder en liste med åpninger mot internett som vi anbefaler alle å ha. Ønsker du ingen eller bare noen fra den lista kan du velge skru av og velge alle åpninger selv.

Første gang du bruker din Knast¶

Start Knast¶

Når du har trykket på "Start opprettelse av Knast" og ventet i noen minutter får du muligheten til å starte Knasten din. Det tar et par minutter å starte Knasten. Når den er klar får du en lenke som du kan åpne for å jobbe i browseren din. Du kan også koble til remote fra lokal VS Code ved å trykke på "Bruk Knast via VS Code lokalt" og følge oppskriften der.

Følgende må gjøres på lokal maskin for å koble VS Code til Knast:¶

Hopp over steg 4-6 hvis du har gjort disse tidligere.

Installere extension Remote - SSH i VS Code
Logg inn i Google Cloud (kjøres lokalt)
gcloud auth login
Opprette SSH-tunnel (kjøres lokalt)
gcloud workstations start-tcp-tunnel --cluster=knada --config=DIN_NAV_IDENT --region=europe-north1 --project knada-gcp --local-host-port=:33649 DIN_NAV_IDENT 22
Husk å sette inn Nav-identen din der det står DIN_NAV_IDENT. Porten 33649 er tilfeldig valgt og kan byttes med en annen port om du ønsker det.
Opprette SSH-nøkkel (kjøres lokalt, hopp over om du allerede har gjort dette)
Sett et passord på SSH-nøkkelen. Du vil aldri bli bedt om å bytte dette.
ssh-keygen -t ed25519 -C "din_epost_email@nav.no"
Få Knast til å stole på din SSH-nøkkel (kjøres på Knast, hopp over om du allerede har gjort dette)
- Opprette directory ~/.ssh/ hvis det ikke allerede finnes
- Opprett filen authorized_keys i ~/.ssh/
- Lime inn innholdet fra public-delen av SSH-nøkkelen fra .ssh/id_ed25519.pub eller tilsvarende på lokal maskin inn i authorized_keys på Knast
Legg til knast i ssh-configen (kjøres lokalt, hopp over om du allerede har gjort dette)
echo -e "\nHost knast\n\tHostName localhost\n\tPort 33649\n\tUser user">>~/.ssh/config
Hvis valgte en annen port i steg 3 må du velge den her også.
Koble til knast
- Åpne Command Palette i VS Code (⇧⌘P / Ctrl+Shift+P)
- Velg/Skriv inn: Remote - SSH: Connect to host...
- Skriv inn: knast

Dette er også beskrevet med skjermbilder i dokumentasjonen til Google Workstations.

Python¶

For å kjøre pythonkode bør du installere en egen pythonversjon. Les hvordan det gjøres best med uv.

Extensions¶

For at VSCode skal fungere godt må du installere noen extensions. Om du bruker VSCode i browser kjører du egentlig open source versjonen som kalles Code - OSS. Den største forskjellen mellom disse to er at Code - OSS ikke støtter alle extensions som VSCode gjør. Om du derimot kobler til remote fra din lokale VSCode vil du kunne bruke alle extensions. Merk at mange extensions trenger å snakke med internett. Så hvis du opplever problemer med noen av dem bør du følge med på "blokkerte URLer" på Min Knast. Les mer om nettverk her.

Generelle råd¶

Andre ting verdt å tenke på er nbstripout, dependabot og autentisering mot github og gcp. Her gjelder det samme som i Generelle råd for Jupyterhub.