DevOps-bootcamp · Oppitunti

Yhdistelmäactionit ja julkaiseminen Marketplaceen

Rakentakaa useita vaiheita yhdistäviä yhdistelmäactioneja, versioikaa ne asianmukaisesti ja julkaiskaa mukautettu actioninne GitHub Marketplaceen uudelleenkäyttöä varten.

Oppitunti 4/413 vaihetta

Yhdistelmäactionit ja julkaiseminen Marketplaceen 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.

Kolme mukautettujen toimintojen tyyppiä

GitHub tukee kolmea tapaa kirjoittaa mukautettu toiminto:

JavaScript-toiminnot — suorittavat Node-koodia
Docker-toiminnot — suorittavat koodia kontin sisällä
Composite-toiminnot — kokoavat useita workflow-vaiheita yhteen

Tässä oppitunnissa keskitytään composite-toimintoihin ja julkaisemiseen.

Mikä composite-toiminto on

Composite-toiminto paketoi useita run-vaiheita ja muita toimintokutsuja yhdeksi uudelleenkäytettäväksi kokonaisuudeksi ilman JavaScriptin kirjoittamista tai Docker-levykuvan rakentamista.

Se sopii erinomaisesti toistuvan komentotulkkikomentojen sarjan kokoamiseen.

action.yml-tiedosto

Jokainen toiminto määritellään sen juuressa olevassa action.yml-tiedostossa. Määritä composit-toiminnolle runs.using-arvoksi composite.

name: Setup Project
description: Install deps and build
runs:
  using: composite
  steps:
    - run: npm ci
      shell: bash
    - run: npm run build
      shell: bash

Shell on pakollinen

Hienovarainen sääntö: composite-toiminnoissa jokaisen run-vaiheen on pakko määrittää shell. Sen unohtaminen on yleisin virhe composite-toimintoja kirjoitettaessa.

    - run: echo 'hello'
      shell: bash

Syötteiden määrittäminen

Tee toiminnosta määritettävä inputs-syötteiden avulla. Kutsuja välittää arvot with-määritteellä, ja niihin viitataan muodossa inputs.<name>.

inputs:
  node-version:
    description: Node version
    required: false
    default: '20'
runs:
  using: composite
  steps:
    - run: echo Using ${{ inputs.node-version }}
      shell: bash

Tulosteiden määrittäminen

Yhdistelmätoiminto voi palauttaa tulosteita. Vaihe kirjoittaa arvon kohteeseen GITHUB_OUTPUT, ja toiminto yhdistää sen nimettyyn tulosteeseen.

outputs:
  build-id:
    value: ${{ steps.gen.outputs.id }}
runs:
  using: composite
  steps:
    - id: gen
      run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
      shell: bash

Paikallisen toiminnon käyttäminen

Voitte viitata samaan repositorioon tallennettuun toimintoon polun avulla. Tämä on kätevää kehitysvaiheessa ennen julkaisemista.

    steps:
      - uses: actions/checkout@v4
      - uses: ./.github/actions/setup-project
        with:
          node-version: '20'

Versiointi tageilla

Julkaistuihin toimintoihin viitataan git ref -viittauksella. Hyvä käytäntö on merkitä julkaisut tagilla v1.0.0 ja ylläpitää lisäksi päivittyvää tagia v1.

@v1-tunnistetta käyttävät kutsujat saavat automaattisesti taaksepäin yhteensopivat päivitykset.

git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --force

Valmistautuminen Marketplace-julkaisuun

Jotta toiminto voidaan julkaista GitHub Marketplacessa, sen on sijaittava julkisessa repositoriossa, jonka action.yml-tiedosto sisältää kentät name ja description sekä mielellään myös kentän branding (kuvake ja väri).

branding:
  icon: package
  color: blue

Julkaisun julkaiseminen

Laadi repositorion Releases-sivulla julkaisu tagillesi. GitHub näyttää valintaruudun Publish this Action to the Marketplace.

Hyväksy sopimus, valitse luokat ja julkaise. Tämän jälkeen kaikki voivat etsiä toimintoa.

Käytön dokumentointi

Hyvän toiminnon mukana toimitetaan selkeä README, jossa on käyttöesimerkki sekä syötteet ja tulosteet.

Toimintoasi arvioivat yritykset tukeutuvat vahvasti tähän dokumentaatioon, joten pidä se täsmällisenä ja kattavana.

Pikatarkistus

Testaa, miten hyvin ymmärrät yhdistelmätoiminnot.

Vastaa interaktiivisessa oppitunnissa

Kertaus

Opitte rakentamaan ja julkaisemaan yhdistelmätoimintoja.

Yhdistelmätoiminnot kokoavat vaiheet runs.using: composite -määrityksen avulla
Jokaiselle suoritusvaiheelle on määritettävä shell erikseen
Uudelleenkäyttöä varten toiminnolle määritetään syötteet ja tulosteet
Merkitkää julkaisut semanttisilla versiolla ja päivittyvällä pääversion tagilla ja julkaiskaa toiminto Marketplaceen

Uudelleenkäytettävien toimintojen avulla tiimit voivat skaalata yhteistä CI/CD-logiikkaa.

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 ”Yhdistelmäactionit ja julkaiseminen Marketplaceen” ilmainen?

Kyllä — voit lukea täällä verkossa kokonaan ilmaiseksi mitkä tahansa DevOps-bootcamp-oppimispolun 3 oppituntia, myös oppitunnin “Yhdistelmäactionit ja julkaiseminen Marketplaceen”. 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 ”Yhdistelmäactionit ja julkaiseminen Marketplaceen”?

Rakentakaa useita vaiheita yhdistäviä yhdistelmäactioneja, versioikaa ne asianmukaisesti ja julkaiskaa mukautettu actioninne GitHub Marketplaceen uudelleenkäyttöä varten. 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 ”Yhdistelmäactionit ja julkaiseminen Marketplaceen”-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

Mukautettujen GitHub Actions -toimintojen kehittäminen
Itse hallitut suorittajat paikalliseen käyttöön
Integrointi yritysjärjestelmiin
Yhdistelmäactionit ja julkaiseminen Marketplaceen

← Takaisin: DevOps-bootcamp