DevOps-bootcamp · Oppitunti

Muutoslokien ja julkaisutietojen luominen

Oppikaa tuottamaan selkeitä muutoslokeja ja automaattisia julkaisutietoja Git-historiasta ja conventional commit -viesteistä.

Oppitunti 4/413 vaihetta

Muutoslokien ja julkaisutietojen luominen on ilmainen DevOps-bootcamp-oppitunti CoddyKitissä. Tämä on oppitunti 4/4. Voit lukea tästä oppimispolusta kokonaan mitkä tahansa 3 oppituntia ilmaiseksi — sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä käytännön harjoittelun sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. Oppitunti kuuluu DevOps-bootcamp-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. DevOps-bootcamp-kurssilla on yhteensä 4 oppituntia.

Mikä on muutosloki

Muutosloki on toimitettu, ihmiselle helposti luettava luettelo kunkin version merkittävistä muutoksista. Se sijaitsee yleensä repositorion juuressa olevassa tiedostossa, kuten CHANGELOG.md.

Miksi muutoslokit ovat tärkeitä

Käyttäjät ja tiimin jäsenet lukevat muutoslokeja ymmärtääkseen:

Uudet ominaisuudet
Virheenkorjaukset
Rikkovat muutokset

Ne tekevät päivityksistä turvallisempia ja nopeampia.

Keep a Changelog -muoto

Yleisen käytännön mukaan merkinnät ryhmitellään otsikoiden alle: Added, Changed, Fixed ja Removed.

## [1.2.0] - 2024-05-01
### Added
- Search filters
### Fixed
- Login redirect bug

Conventional Commitit

Conventional Commits -viesteissä käytetään etuliitteitä, kuten feat:, fix: ja BREAKING CHANGE:, jotta työkalut voivat luoda muutoslokeja automaattisesti.

feat: add CSV export
fix: handle empty cart
feat!: drop Node 14 support

Commitien listaaminen tagin jälkeen

Voitte esikatsella viimeisimmän julkaisun jälkeen tehdyt muutokset käyttämällä git log-komentoa tagialueen kanssa.

git log v1.1.0..HEAD --oneline

Lokien muotoileminen muistiinpanoja varten

Muotoilkaa loki luetteloriveiksi, jotka voi liittää suoraan julkaisutietoihin.

git log v1.1.0..HEAD --pretty=format:'- %s'

Automaattiset muutoslokityökalut

standard-versionin ja conventional-changelogin kaltaiset työkalut lukevat Conventional Commit -viestit ja luovat muutoslokin sekä päivittävät versionumeron.

npx standard-version

GitHubin automaattisesti luomat muistiinpanot

GitHub voi luoda julkaisutiedot automaattisesti yhdistetyistä pull requesteista, kun luotte julkaisun.

gh release create v1.2.0 --generate-notes

Luokittelu tunnisteiden avulla

.github/release.yml-tiedosto yhdistää PR-tunnisteet muutoslokin osioihin, joten muistiinpanot ryhmittelevät virheenkorjaukset ja ominaisuudet automaattisesti.

changelog:
  categories:
    - title: Features
      labels: [feature]

Tarkistaminen ennen julkaisemista

Lukekaa luodut muistiinpanot aina ennen julkaisemista. Automaatio luonnostelee ne, mutta ihminen muokkaa sanamuotoa ja korostaa rikkovat muutokset.

Linkittäminen julkaisuihin

Linkittäkää jokainen muutoslokimerkintä Git-tagiiin ja julkaisusivulle, jotta lukijat pääsevät suoraan tarkastelemaan täsmällistä diffiä.

[1.2.0]: https://github.com/you/repo/compare/v1.1.0...v1.2.0

Pikatarkistus

Testatkaa, miten hyvin ymmärrätte muutoslokit ja julkaisutiedot.

Vastaa interaktiivisessa oppitunnissa

Kertaus

Opitte luomaan muutoslokeja:

Käyttäkää Keep a Changelog -muotoa
Conventional Commitit mahdollistavat automaation
git log v1..HEAD esikatselee muutokset
gh release create --generate-notes luo luonnoksen PR:ien perusteella

Aloita maksutta

Opi DevOps-bootcamp tekoälytuutorin avulla — ilmaiseksi

Kirjoita ja suorita oikeaa koodia selaimessa, saa välitöntä apua tekoälytuutorilta ympäri vuorokauden ja jatka siitä, mihin jäit, verkossa tai sovelluksessa.

Kurssit: 142
Oppitunnit: 568

Aloita opiskelu maksutta Näytä koko kurssi

Usein kysytyt kysymykset

Onko oppitunti ”Muutoslokien ja julkaisutietojen luominen” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa DevOps-bootcamp-oppimispolun 3 oppituntia, myös oppitunnin “Muutoslokien ja julkaisutietojen luominen”. Sen jälkeen CoddyKit PRO avaa kaikki oppitunnit sekä interaktiiviset harjoitukset sisäänrakennetulla koodieditorilla ja ympäri vuorokauden toimivalla tekoälytuutorilla. DevOps-bootcamp-kurssilla on yhteensä 4 oppituntia.

Mitä opin oppitunnilla ”Muutoslokien ja julkaisutietojen luominen”?

Oppikaa tuottamaan selkeitä muutoslokeja ja automaattisia julkaisutietoja Git-historiasta ja conventional commit -viesteistä. Harjoittelet DevOps-bootcamp-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.

Tarvitsenko kokemusta aloittaakseni DevOps-bootcamp-opiskelun?

Aiempi kokemus ei ole tarpeen. CoddyKitin DevOps-bootcamp-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 4/4.

Kuinka kauan ”Muutoslokien ja julkaisutietojen luominen”-oppitunnin suorittaminen kestää?

Useimmat CoddyKitin oppitunnit kestävät noin 5–10 minuuttia. Jokainen oppitunti on lyhyt ja interaktiivinen, joten edistyt tasaisesti ja voit jatkaa siitä, mihin jäit – sekä verkossa että sovelluksessa.

Voinko kirjoittaa ja suorittaa koodia tällä DevOps-bootcamp-oppitunnilla?

Kyllä. Jokainen DevOps-bootcamp-oppitunti sisältää sisäänrakennetun koodieditorin, joten voit kirjoittaa ja suorittaa oikeaa koodia suoraan selaimessa ja saada välitöntä palautetta tekoälyltä – paikallista asennusta ei tarvita.

Kaikki tämän kurssin oppitunnit

Semanttinen versiointi tageilla
Julkaisujen luominen ja hallinta
Release-haarat ja hotfixit
Muutoslokien ja julkaisutietojen luominen

← Takaisin: DevOps-bootcamp