Bileşik Eylemler ve Marketplace'te Yayımlama
Birden çok adımı bir araya getiren bileşik eylemler oluşturun, bunları doğru biçimde sürümleyin ve özel eyleminizi yeniden kullanılmak üzere GitHub Marketplace'te yayımlayın.
Bileşik Eylemler ve Marketplace'te Yayımlama, CoddyKit'te ücretsiz bir CI/CD with GitHub Actions & DevOps Pipelines dersidir. Bu, 4 dersinin 4. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, CI/CD with GitHub Actions & DevOps Pipelines öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. CI/CD with GitHub Actions & DevOps Pipelines kursu toplamda 4 dersten oluşur.
Özel Action'ların Üç Türü
GitHub, özel bir action yazmanın üç yolunu destekler:
- JavaScript action'ları — Node kodu çalıştırır
- Docker action'ları — bir konteyner içinde çalışır
- Bileşik action'lar — birden çok iş akışı adımını bir araya getirir
Bu derste bileşik action'lara ve yayımlamaya odaklanılmaktadır.
Bileşik Action Nedir
Bir bileşik action, JavaScript yazmadan veya Docker imajı oluşturmadan çeşitli çalıştırma adımlarını ve diğer action çağrılarını yeniden kullanılabilir tek bir birim hâlinde paketler.
Tekrarlanan bir kabuk komutları dizisini kapsüllemek için idealdir.
action.yml Dosyası
Her action, kök dizinindeki bir action.yml dosyasıyla tanımlanır. Bileşik action için runs.using değerini composite olarak ayarlayın.
name: Setup Project
description: Install deps and build
runs:
using: composite
steps:
- run: npm ci
shell: bash
- run: npm run build
shell: bashShell Bildirimi Zorunludur
İnce ama önemli bir kural: bileşik action'larda her run adımı bir shell bildirmek zorundadır. Bunu unutmak, bileşik action yazarken en sık yapılan hatadır.
- run: echo 'hello'
shell: bashGirdileri Tanımlama
Action'ı inputs ile yapılandırılabilir hâle getirin. Çağıranlar değerleri with aracılığıyla iletir; siz de bu değerlere inputs.<name> olarak başvurursunuz.
inputs:
node-version:
description: Node version
required: false
default: '20'
runs:
using: composite
steps:
- run: echo Using ${{ inputs.node-version }}
shell: bashÇıktıları Tanımlama
Bileşik bir eylem outputs döndürebilir. Bir adım GITHUB_OUTPUT dosyasına yazar ve eylem bunu adlandırılmış bir çıktıyla eşler.
outputs:
build-id:
value: ${{ steps.gen.outputs.id }}
runs:
using: composite
steps:
- id: gen
run: echo "id=$(date +%s)" >> $GITHUB_OUTPUT
shell: bashYerel Eylem Kullanma
Aynı depoda saklanan bir eyleme yolunu belirterek başvurabilirsiniz; bu, yayımlamadan önce geliştirme yaparken oldukça kullanışlıdır.
steps:
- uses: actions/checkout@v4
- uses: ./.github/actions/setup-project
with:
node-version: '20'Etiketlerle Sürümleme
Yayımlanan eylemlere git referansı ile başvurulur. En iyi uygulama olarak sürümleri v1.0.0 şeklinde etiketleyin ve ayrıca hareketli bir v1 etiketi tutun.
@v1 kullanan çağrılar, geriye dönük uyumluluğu bozmayan güncellemeleri otomatik olarak alır.
git tag -a v1.0.0 -m 'release'
git tag -f v1
git push --tags --forceMarketplace İçin Hazırlık
GitHub Marketplace'te yayımlamak için eylem, içinde name, description ve tercihen branding (simge ve renk) bulunan herkese açık bir depoda yer almalıdır.
branding:
icon: package
color: blueSürümü Yayımlama
Deponun Releases sayfasında etiketiniz için bir sürüm taslağı oluşturun. GitHub, Publish this Action to the Marketplace onay kutusunu gösterir.
Sözleşmeyi kabul edin, kategorileri seçin ve yayımlayın. Eyleminiz artık herkes tarafından aranabilir.
Kullanımı Belgeleme
İyi bir eylem, kullanım örneğini, girdileri ve outputs'u gösteren anlaşılır bir README ile birlikte sunulur.
Eyleminizi değerlendiren kurumsal ekipler büyük ölçüde bu belgelere güvenir; bu nedenle belgeleri doğru ve eksiksiz tutun.
Kısa Kontrol
Bileşik eylemler hakkındaki anlayışınızı sınayın.
Özet
Bileşik eylemler oluşturmayı ve yayımlamayı öğrendiniz.
- Bileşik eylemler, adımları
runs.using: compositearacılığıyla bir araya getirir. - Her çalıştırma adımı açıkça bir
shellgerektirir. - Yeniden kullanım için inputs ve outputs değerlerini dışa açın.
- Anlamsal sürümler ve hareketli bir ana sürüm etiketi kullanarak etiketleyin, ardından Marketplace'te yayımlayın.
Yeniden kullanılabilir eylemler, ekiplerin ortak CI/CD mantığını ölçeklendirme yöntemidir.
Sıkça Sorulan Sorular
“Bileşik Eylemler ve Marketplace'te Yayımlama” dersi ücretsiz mi?
Evet — “Bileşik Eylemler ve Marketplace'te Yayımlama” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve CI/CD with GitHub Actions & DevOps Pipelines kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. CI/CD with GitHub Actions & DevOps Pipelines kursu toplamda 4 dersten oluşur.
“Bileşik Eylemler ve Marketplace'te Yayımlama” dersinde ne öğreneceğim?
Birden çok adımı bir araya getiren bileşik eylemler oluşturun, bunları doğru biçimde sürümleyin ve özel eyleminizi yeniden kullanılmak üzere GitHub Marketplace'te yayımlayın. CI/CD with GitHub Actions & DevOps Pipelines ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.
CI/CD with GitHub Actions & DevOps Pipelines öğrenmeye başlamak için deneyim gerekli mi?
Önceden deneyim gerekmez. CoddyKit'te CI/CD with GitHub Actions & DevOps Pipelines, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 4. dersidir.
“Bileşik Eylemler ve Marketplace'te Yayımlama” dersi ne kadar sürer?
Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.
Bu CI/CD with GitHub Actions & DevOps Pipelines dersinde kod yazıp çalıştırabilir miyim?
Evet. Her CI/CD with GitHub Actions & DevOps Pipelines dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.
Bu kursun tüm dersleri
- Özel GitHub Actions Geliştirme
- Şirket İçi Kullanım için Kendinden Barındırılan Çalıştırıcılar
- Kurumsal Sistemlerle Entegrasyon
- Bileşik Eylemler ve Marketplace'te Yayımlama