Hyppää sisältöön

Yleisohjeet

Warning

Käytäthän opettajan sinulle antamaasi repositoriota, jotta opettajalla on automaattisesti pääsy sinun työhösi. Varmista, että repositoryn juuressa on README.md-tiedosto, josta alkaen käyttäjä kuljetetaan eri ohjeiden äärelle. Jos dokumentaatio on repositorion punainen lanka, niin README.md on lankakerän pää. Siitä on hyvä linkittää kaikkiin ohjeisiin, jotta opettaja löytää ne helposti.

Repositorio

Käytä repositoriossa ns. monorepo-rakennetta, jossa kaikki harjoitukset sijaitsevat samassa repositoriossa. Jokaisella harjoituksella on oma kansio. Esimerkiksi:

.
├── README.md
├── cdc01
│   └── compose.yml
├── csc01
│   ├── MEMO.md
│   └── compose.yml
├── lak01
│   ├── main.py
│   └── compose.yml
├── orc01
│   ├── dags/
│   └── compose.yaml
└── <ID>
    ├── ...
    └── ...

Tarkka repositorion rakenne on kuitenkin sinun päätettävissä. Varmista kuitenkin, että se on selkeä siten, että opettaja löytää README.md-tiedoston ja sitä kautta muut harjoitukset. On esimerkiksi täysin sallittua antaa juokseva järjestysnumero tekemisille harjoituksilla, kuten 01_CDC01, 02_CSC01 jne.

CLI-työskentely

Kun ajat harjoituksia, siirry kyseiseen hakemistoon, ja aja komennot siellä. Esimerkiksi jos teet CDC01-harjoitusta, niin:

cd cdc01
docker compose up -d

Videot

Videon tekninen toteutus

Jakaminen

Palautus hoidetaan lisäämällä linkki Reppu-palvelun palautuslaatikkoon. Linkin tulee olla luotu siten, että se toimii opettajan koneella. Pikaohje tähän on:

  • Jos YouTube, valitse Visibility: Unlisted.
  • Jos OneDrive, jaa linkkinä siten, että kaikilla linkin saaneilla (ainakin KamiT AD:ssa) on lupa nähdä se.

OneDrive-kohtaan on alla tarkempi ohje.

Kuva 1: Tiedoston jakaminen OneDrivessä vaatii Share-ominaisuuden käyttöä. Ethän siis kopioi URL:ia selaimen osoiteriviltä vaan käytä Share-ominaisuutta. Kohdasta Link Settings pitäisi löytyä kuvassa näkyvä menu.

Tallennus

Voit tallentaa videon esimerkiksi seuraavilla työkaluilla:

  • Microsoft Clipchamp. Työkalu on käytettävissä suoraan selaimesta ja video tallentuu pilvipalveluun (KamiT OneDriveen). Kuvanlaatu minun kokeilun perusteella 720p.
  • OBS Studio. Avoimen lähdekoodin videotallennin ja striimaustyökalu. Tiedosto tallentuu lokaalisti todella hyvälaatuisena ja on täten helposti leikattavissa.

Esimerkki

Video 1: Esimerkki videosta, joka on toteutettu Clipchampilla. Videon aiheena on Brutus -bruteforcetyökalun minilab.

Opettajan omat materiaalit on tyypillisesti tallennettu OBS Studiolla, leikattu Adobe Premierellä ja ääniraita on paranneltau Adobe Auditionilla. Jotta odotukset pysyisivät maltillisina, nauhoitin Clipchamp-referenssin maisteriopintojen ohessa kyberturvallisuutta käsittelevälle kursille(ks. Video 1 yltä). Video on tallennettu Ubuntussa Chrome-selaimella, käyttäen tavallista web-kameraa ja langallista headsettiä.

Tip

Huomannet, että 720p-laadun kansssa Videon 1 fonttikoko on aivan ehdoton minimi. Jos sinulla on 4K-työpöytä, kasvata fonttikokoa. Videolla on 1440p resoluutio työpöydässä ja VS Codessa vakio fonttikoko.

Leikkaus

Videon leikkaaminen ei ole millään tavoin pakollista. Tämän kurssin videot on mahdollista nauhoittaa yhdellä otolla. Jos kuitenkin haluat leikata videota, siihen soveltuu ainakin:

  • Microsoft Clipchamp. Online-editori. Ainakin alun ja lopun leikkaus onnistuu helposti.
  • Shotcut. Avoimen lähdekoodin videoeditointiohjelma, joka on saatavilla useille alustoille.
  • DaVinci Resolve. Tehokas videoeditointiohjelma, joka tarjoaa laajat ominaisuudet ilmaisversiossaan. Oppimiskäyrä on jyrkähkö.

Suosittelen opiskelijoita jakamaan keskenään vinkkejä helpoista editoreista. Opettajalla on kokemusta pääasiassa Premierestä tai DaVinci Resolvea, jotka eivät ole aivan helpoimmasta päästä.

Videon sisällölliset ohjeet

Palautat lyhyt video. Älä tee tunnin luentoa vaan ns. perjantaidemo, jonka voisi esittää yrityksen perjantaisessa videopalaverisessiossa. Harjoituksesta riippuen noin 5-15 minuuttia on hyvä kesto. Videolla:

  • Kerrot, kuinka monta tuntia käytit tehtävään. 1
  • Selität sen osan terminologiasta, joka on oleellista ymmärtää, jotta ymmärtäisi, mitä harjoituksessa tapahtuu. Kuvittele, että yleisössä on yrityksen toisten tiimien jäseniä, jotka eivät välttämättä täysin tiedä, mitä työkaluja ovat esimerkiksi Airflow, DuckDB tai Apache Spark.
  • Esittelet harjoituksessa luodun kokonaisuuden.
    • Palvelu nostetaan pystyyn videolla (esim. docker compose up)
    • Palvelu health status on todistettu. Jos palveluun liittyy web-käyttöliittymä, näytä se. Jos ei, näytä vaikka docker status.
    • Palvelun tyypillinen toiminnallisuus näkyy videolla. Esimerkiksi siihen syötetään dataa, näytetään ja selitetään datan kulku järjestelmässä, ja selitetään, mitä ja miksi tulee tuloskseksi.

Huomaa, että tarkat ohjeet riippuvat harjoituksesta. Osa sinun osaamistasi on tunnistaa, mikä juuri kyseisessä tehtävässä on oleellista. Kussakin harjoituksessa on kuitenkin annettu vinkkejä tai vaatimuksia, jotka sinun tulee huomioida.

Opettaja arvioi työsi Arviointityökalulla. Valitse vetovalikosta Videoitu demo, ja voit kokeilla, kuinka arvioisit itse oman työsi.

  1. Tämä on tärkeää, jotta voin optimoida pisteytysmallia tulevaisuudessa. Et saa enempää tai vähempää pisteitä siitä, kuinka paljon käytit aikaa, mutta arvosanasi laskee, jos et ilmoita käyttämääsi aikaa. ↩