Mukautetut Actionit ja Marketplace
Tutustukaa GitHub Actions Marketplaceen, sen valmiisiin Actioneihin ja omien mukautettujen Actionien luomiseen.
Mukautetut Actionit ja Marketplace on ilmainen Git- ja GitHub-ammattilaisen työnkulku-oppitunti CoddyKitissä. Tämä on oppitunti 3/4. Voit lukea koko oppitunnin alta ilmaiseksi ja harjoitella sen jälkeen käytännössä selaimessa sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla. Oppitunti kuuluu Git- ja GitHub-ammattilaisen työnkulku-oppimispolkuun, ja edistymisesi synkronoituu verkon ja CoddyKit-sovelluksen välillä. Git- ja GitHub-ammattilaisen työnkulku-kurssilla on yhteensä 4 oppituntia.
Tutustu GitHub Actions Marketplaceen
Tervetuloa GitHub Actions Marketplaceen! Se on aktiivinen keskus, josta löydät tuhansia GitHubin, avoimen lähdekoodin yhteisön jäsenten ja kaupallisten kumppanien luomia valmiita toimintoja.
Nämä toiminnot on helppo integroida työnkulkuihisi, mikä säästää aikaa ja vaivaa, kun voit hyödyntää olemassa olevia ratkaisuja yleisiin tehtäviin.
Sopivan toiminnon löytäminen
Marketplacessa suunnistaminen on helppoa. Voit hakea toimintoja avainsanoilla, suodattaa niitä luokan, kuten ”CI/CD” tai ”Deployment”, mukaan ja järjestää ne suosion perusteella.
- Etsi toimintoja, joilla on paljon tähtiä ja joita ylläpidetään aktiivisesti.
- Tarkista toiminnon dokumentaatiosta käyttöohjeet sekä syötteet ja tulosteet.
- Tarkista, kuinka monta kertaa toimintoa on käytetty julkisissa repositorioissa saadaksesi näyttöä sen suosiosta.
Valmiin toiminnon integrointi
Marketplacen toiminnon käyttäminen on helppoa. Viittaat siihen työnkulun YAML-tiedostossa uses-avaimella, jota seuraa toiminnon omistaja/repo@versio.
Yleinen esimerkki on actions/checkout, joka hakee repositoriosi koodin, jotta työnkulkusi voi käyttää sitä.
name: Marketplace Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- name: Checkout repository
uses: actions/checkout@v4
- name: Say hello
run: echo "Hello from workflow!"Toimintojen syötteet ja tulosteet
Monet toiminnot hyväksyvät syötteitä, joilla niiden toimintaa voi mukauttaa. Syötteet määritetään with-avaimella. Toiminnot voivat myös tuottaa tulosteita, joita työnkulun muut vaiheet voivat käyttää.
Esimerkiksi toiminnolle actions/setup-node voi antaa syötteen node-version.
name: Node Setup Demo
on: [push]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Setup Node.js 18.x
uses: actions/setup-node@v3
with:
node-version: '18.x'
- name: Install dependencies
run: npm installMilloin oma toiminto kannattaa rakentaa
Vaikka Marketplace tarjoaa paljon vaihtoehtoja, tarvitset joskus jotain tiettyä. Silloin mukautetut toiminnot ovat hyödyllisiä!
Voit rakentaa mukautetun toiminnon esimerkiksi:
- yrityksen sisäisten työkalujen automatisointiin
- integrointiin sellaisen ainutlaatuisen API:n kanssa, jota nykyiset toiminnot eivät tue
- projektisi koontiprosessiin liittyvien erittäin erikoistuneiden tehtävien suorittamiseen
Mukautettujen toimintojen tyypit
Voit luoda kahden päätyyppisiä mukautettuja toimintoja:
- JavaScript-toiminnot: Nämä suoritetaan suoraan suorittimen koneella Node.js:n avulla. Niitä on usein nopeampi kehittää ja helpompi jakaa.
- Docker-säilötoiminnot: Nämä suoritetaan Docker-säilön sisällä. Ne sopivat erinomaisesti ympäristöjen ja riippuvuuksien kapselointiin ja varmistavat yhdenmukaisen suorituksen eri suorittimilla.
Keskitymme yksinkertaisuuden vuoksi JavaScript-toimintoihin.
`action.yml`-tiedosto
Jokainen mukautettu toiminto tarvitsee action.yml-tiedoston. Tämä tiedosto määrittää toiminnon metatiedot, kuten sen nimen, kuvauksen, hyväksymät syötteet, tuottamat tulosteet ja suoritustavan.
Se toimii toimintosi manifestina ja kertoo GitHub Actionsille kaiken tarvittavan.
name: 'My Custom Greeting Action'
description: 'Greets a person with a custom message.'
inputs:
who-to-greet:
description: 'Who to greet'
required: true
default: 'World'
outputs:
time:
description: 'The time we greeted you'
runs:
using: 'node16'
main: 'index.js'Yksinkertaisen JavaScript-toiminnon rakentaminen
Luodaan hyvin yksinkertainen JavaScript-toiminto. Tarvitset index.js-tiedoston, joka määritetään tiedostossa action.yml, ja yleensä myös riippuvuuksia varten package.json-tiedoston.
@actions/core-paketti on välttämätön työnkulun kanssa toimimiseen, esimerkiksi syötteiden hakemiseen ja tulosteiden asettamiseen.
const core = require('@actions/core');
async function run() {
try {
const nameToGreet = core.getInput('who-to-greet');
console.log(`Hello ${nameToGreet}!`);
const time = (new Date()).toTimeString();
core.setOutput("time", time);
} catch (error) {
core.setFailed(error.message);
}
}
run();Mukautetun toiminnon integrointi
Käytä mukautettua toimintoa sijoittamalla sen tiedostot, kuten action.yml ja index.js, repositoriosi alihakemistoon. Viittaa siihen työnkulussa suhteellisella polulla uses: ./path/to/your/action.
Näin voit testata toimintoa paikallisesti ennen sen mahdollista julkaisemista Marketplacessa.
name: Use Custom Action Demo
on: [push]
jobs:
greet:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Run my custom action
uses: ./my-custom-action # Path to action directory
with:
who-to-greet: 'CoddyKit User'
- name: Get the output time
run: echo "The greeting time was ${{ steps.run-my-custom-action.outputs.time }}"Mukautetun toiminnon osat
Olet oppinut keskeiset osat, joita tarvitaan mukautettujen GitHub Actions -toimintojen luomiseen ja käyttämiseen. Testataan, mitä olet oppinut!
Kertaus: Marketplace ja mukautetut toiminnot
Hienoa työtä! Olet tutustunut sekä GitHub Actions Marketplacen että mukautettujen toimintojen mahdollisuuksiin.
- Marketplace tarjoaa runsaasti valmiita toimintoja työnkulkujen sujuvoittamiseen.
- Mukautettujen toimintojen avulla voit laajentaa GitHub Actionsia vastaamaan projektisi tai organisaatiosi erityistarpeita.
Yhdistämällä nämä voit rakentaa erittäin tehokkaita ja juuri tarpeisiisi mukautettuja automaatioputkia!
Opi Git- ja GitHub-ammattilaisen työnkulku 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
- 12
- Oppitunnit
- 48
Usein kysytyt kysymykset
Onko oppitunti ”Mukautetut Actionit ja Marketplace” ilmainen?
Kyllä – oppitunnin ”Mukautetut Actionit ja Marketplace” koko tekstin voi lukea täällä verkossa ilmaiseksi. Jos haluat harjoitella interaktiivisesti sisäänrakennetulla koodieditorilla ja ympäri vuorokauden käytettävissä olevan tekoälytuutorin avulla sekä avata koko Git- ja GitHub-ammattilaisen työnkulku-kurssin, päivitä CoddyKit PROhon. Git- ja GitHub-ammattilaisen työnkulku-kurssilla on yhteensä 4 oppituntia.
Mitä opin oppitunnilla ”Mukautetut Actionit ja Marketplace”?
Tutustukaa GitHub Actions Marketplaceen, sen valmiisiin Actioneihin ja omien mukautettujen Actionien luomiseen. Harjoittelet Git- ja GitHub-ammattilaisen työnkulku-aihetta koodilla, jonka suoritat suoraan selaimessa. Ympäri vuorokauden käytettävissä oleva tekoälytuutori vastaa kysymyksiisi oppitunnin aikana.
Tarvitsenko kokemusta aloittaakseni Git- ja GitHub-ammattilaisen työnkulku-opiskelun?
Aiempi kokemus ei ole tarpeen. CoddyKitin Git- ja GitHub-ammattilaisen työnkulku-oppimispolku sopii vasta-alkajista edistyneisiin, joten voit aloittaa tästä tai alusta ja edetä omaan tahtiisi. Tämä on oppitunti 3/4.
Kuinka kauan ”Mukautetut Actionit ja Marketplace”-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ä Git- ja GitHub-ammattilaisen työnkulku-oppitunnilla?
Kyllä. Jokainen Git- ja GitHub-ammattilaisen työnkulku-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
- GitHub Actionsin perusteet
- CI/CD-työnkulkujen rakentaminen
- Mukautetut Actionit ja Marketplace
- Salaisuudet ja ympäristömuuttujat Actionseissa