Automatické vydání nové verze Ruby SDK krok za krokem

1. Nastavíte GitHub Action pro vydání nové verze SDK.
2. Zveřejníte novou verzi SDK:
   • Založíte si účet na RubyGems.
   • Vytvoříte API klíč pro RubyGems a bezpečně ho uložíte do GitHubu.
   • Nastavíte GitHub workflow, který každou novou verzi SDK automaticky zveřejní.

1. V repozitáři na GitHubu přejděte do Settings > Actions > General a zaškrtněte volbu „Allow GitHub Actions to create and approve pull requests“.

1. V kořenovém adresáři projektu vytvořte složku .github/workflows/. Sem patří konfigurační soubory pro GitHub Actions.
2. V této složce vytvořte nový YAML soubor. Pojmenujte ho release-please.yml.
3. Do konfiguračního souboru zkopírujte následující kód:

# This workflow opens and updates a pull request with a new package version
# based on code changes.

# The pull request updates the version in version.rb, updates the changelog
# and creates release tags.

# https://github.com/marketplace/actions/release-please-action

on:
  push:
    branches:
      - master

permissions:
  contents: write
  pull-requests: write

name: release-please

jobs:
  release-please:
    runs-on: ubuntu-22.04
    steps:
      - uses: google-github-actions/release-please-action@v3.7.10
        with:
          release-type: ruby
          package-name: release-please-action
          version-file: "lib/your_gem_name/version.rb"
          pull-request-title-pattern: "chore(release): ${version}"
          pull-request-header: ":robot: Merge this PR to release a new version"

1. Pokud jste SDK už dřív vydávali, ujistěte se, že commit s posledním vydáním má připojený tag verze (ve formátu „v2.1.1“) a že jste tento tag nahráli na GitHub. release-please podle něj určuje další číslo verze. Bez takového tagu navrhne jako další verzi „v1.0.0“.

2. Tyto změny zacommitujte a nahrajte na GitHub. Tím je workflow hotové. Až příště někdo přidá něco vydatelného s commit zprávou podle konvence (prefix fix: nebo feat:), release-please otevře pull request. Jak přidáváte další kód, automaticky tento pull request aktualizuje. Až budete připraveni vydat novou verzi SDK, pull request mergnete. Verze se vydá a aktualizované SDK se zveřejní na RubyGems.

1. Než SDK poprvé zveřejníte, založte si účet na RubyGems tady.
2. Přejděte do Settings > API keys a po vyzvání zadejte heslo. Klikněte na „New API key“. Zvolte pro klíč název, ujistěte se, že je vybraný scope „Push rubygem“, a klíč vytvořte.
3. API klíč zkopírujte.
4. Otevřete svůj projekt na GitHubu. Přejděte do Settings > Security > Secrets and Variables > Actions a klikněte na „New repository secret“.
5. Do pole Name napište RUBYGEMS_API_KEY.
6. Do pole Secret vložte API klíč z kroku 3. Potvrďte tlačítkem „Add secret“.

1. V projektu přejděte do složky .github/workflows (pokud ještě neexistuje, vytvořte ji) a vytvořte nový YAML soubor. Pojmenujte ho například rubygems-publish.yml.
2. Do konfiguračního souboru zkopírujte následující kód:

# This workflow will publish a gem to rubygems.org when a release is created

name: Publish Gem

on:
  push:
    branches:
      - master

jobs:
  publish:
    if: contains(github.event.head_commit.message, 'chore(release)')
    runs-on: ubuntu-22.04

    steps:
      - uses: actions/checkout@v3.5.3
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: "2.7"
      - run: gem build
      # add RubyGems API key into the credentials file and update permissions
      - run: |
          cat << EOF > ~/.gem/credentials
          ---
          :rubygems_api_key: ${RUBYGEMS_API_KEY}
          EOF
          chmod 0600 ~/.gem/credentials
        env:
          RUBYGEMS_API_KEY: ${{ secrets.RUBYGEMS_API_KEY }}
      - run: gem push *.gem

1. Tento nový soubor zacommitujte do hlavní větve projektu a změny nahrajte do origin repozitáře na GitHubu.

---

• Automatické vydání pro JavaScript
• Automatické vydání pro PHP
• Prohlédněte si náš nástroj, který automatizuje všechny technologie najednou

---

• Co je to SDK a jak pomůže vašemu byznysu?
• Proč váš produkt potřebuje SDK