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

1. Nastavíte GitHub Action, který vydá novou verzi SDK.
2. Publikujete novou verzi SDK:
   • Založíte si účet na npm.
   • Bezpečně uložíte npm API token do GitHubu.
   • Nastavíte GitHub Action, který nové verze SDK publikuje automaticky.

1. V GitHub repozitáři přejděte do Settings > Actions > General a ujistěte se, že je zaškrtnutá volba „Allow GitHub Actions to create and approve pull requests“.

1. V kořeni projektu vytvořte adresář .github/workflows/. Konfigurační soubory GitHub Actions vždy patří sem.
2. V tomto adresáři vytvořte nový konfigurační YAML soubor. Pojmenujte ho release-please.yml.
3. Do souboru zkopírujte tento 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 package.json, 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: node
          package-name: release-please-action
          pull-request-title-pattern: "chore(release): ${version}"
          pull-request-header: ":robot: Merge this PR to release a new version"

1. Pokud jste SDK už někdy vydávali, ujistěte se, že commit posledního vydání má připojený tag verze (ve formátu „v2.1.1“) a že je tento tag nahraný na GitHubu. release-please z tohoto tagu odvodí další číslo verze. Pokud takový tag neexistuje, release-please navrhne jako další verzi „v1.0.0“.

2. Všechny tyto změny zacommitujte a nahrajte do GitHub repozitáře. Workflow je teď nastavené. Až příště někdo přidá něco k vydání s konvenční commit zprávou (s prefixem fix: nebo feat:), release-please otevře pull request. Jak budete přidávat další kód, bude se ten pull request automaticky aktualizovat. Až budete připraveni vypustit novou verzi SDK, prostě ho zmergujete.

1. Než SDK poprvé publikujete, založte si účet na npm na npmjs.com.
2. Přejděte do Account > Access Tokens a vygenerujte nový Classic Token typu Automation. Tady je víc informací o npm tokenech.
3. Token zkopírujte.
4. Otevřete GitHub stránku vašeho projektu. Přejděte do Settings > Security > Secrets and Variables > Actions a klikněte na „New repository secret“.
5. Do pole Name napište NPM_TOKEN.
6. Do pole Secret vložte token z kroku 3. Potvrďte kliknutím na „Add secret“.

1. Ve svém projektu otevřete složku .github/workflows (nebo ji vytvořte, pokud ještě neexistuje) a vytvořte nový konfigurační YAML soubor. Pojmenujte ho například npm-publish.yml.
2. Do souboru zkopírujte tento kód:

# This workflow will publish a package to npmjs.com when a release is created

# https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages

name: Node.js Package

on:
  push:
    branches:
      - master

jobs:
  publish-npm:
    if: contains(github.event.head_commit.message, 'chore(release)')
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3.5.3
      - uses: actions/setup-node@v3.7.0
        with:
          node-version: 18.16.1
          registry-url: https://registry.npmjs.org/
      - run: npm publish --access public
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

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

---

• Automatické vydání pro Ruby
• Automatické vydání pro PHP
• Prozkoumejte náš nástroj, který automatizuje všechny technologie naráz

---

• SDK: Co to je a jak může pomoct mému byznysu?
• Proč váš produkt potřebuje SDK