ユーザ用ツール

サイト用ツール


gh-actions

**文書の過去の版を表示しています。**

Error loading plugin markdowku
Error: Class "dokuwiki\Parsing\Handler\Quote" not found
More info is available in the error log.

GitHub Actions

このページでは、GitHub Actionsを利用して、GitHub Releaseの作成と同時にModParksへVersionを登録する方法を説明します。

APIキーを作成する

GitHub ActionsからModParks APIを利用するにはAPIキーが必要です。

  • ModParksへログインします。
  • アカウント設定を開きます。
  • APIキーを作成します。
  • 発行されたAPIキーをコピーします。

GitHub Secretsを設定する

APIキーはGitHub Secretsへ登録します。

  • GitHubリポジトリを開きます。
  • SettingsSecrets and variablesActions を開きます。
  • New repository secret をクリックします。
  • NameMODPARKSAPIKEY を入力します。
  • Secret に先ほどコピーしたAPIキーを入力します。
  • Add secret をクリックします。

ワークフローを作成する

.github/workflows/release.yml を作成し、次の内容を記述します。

name: Release

on:
push:
tags:
- "v*"

jobs:
build:
runs-on: ubuntu-latest
 
```
permissions:
  contents: write

steps:
  - uses: actions/checkout@v4

  - uses: actions/setup-java@v4
    with:
      distribution: temurin
      java-version: 21
      cache: gradle

  - uses: gradle/actions/setup-gradle@v4

  - name: Grant execute permission
    run: chmod +x gradlew

  - name: Build
    run: ./gradlew build

  - name: Create Release
    uses: softprops/action-gh-release@v2
    with:
      files: |
        build/libs/*.jar
      body: |
        ${{ github.event.head_commit.message }}
      generate_release_notes: true

  - name: Register to ModParks
    env:
      MODPARKS_URL: https://modparks.pitan76.net
      PROJECT_SLUG: your-project
      VERSION_NUMBER: ${{ github.ref_name }}
    run: |
      FILE_NAME=$(basename build/libs/*.jar)
      FILE_URL="https://github.com/${{ github.repository }}/releases/download/${VERSION_NUMBER}/${FILE_NAME}"
 
      curl -X POST "$MODPARKS_URL/api/v1/projects/$PROJECT_SLUG/versions" \
        -H "Authorization: Bearer ${{ secrets.MODPARKS_API_KEY }}" \
        -F "versionNumber=$VERSION_NUMBER" \
        -F "mcVersions=1.21.8" \
        -F "loaders=fabric" \
        -F "changelog=${{ github.event.head_commit.message }}" \
        -F "fileUrl=$FILE_URL"
```

設定を変更する

ワークフロー内の以下の項目は、自分のプロジェクトに合わせて変更してください。

項目説明
PROJECT_SLUGModParksのプロジェクトスラッグ
mcVersions対応するMinecraftバージョン(複数指定可)
loaders対応するローダー(複数指定可)

Releaseを公開する

ワークフローをコミットしたら、タグを作成してGitHubへプッシュします。

git tag v1.0.0
git push origin v1.0.0

タグのプッシュ後、GitHub Actionsが実行されます。

正常に完了すると、

  • GitHub Releaseが作成されます。
  • ModParksへ新しいVersionが登録されます。

トラブルシューティング

症状原因・対処方法
401 UnauthorizedMODPARKSAPIKEY が正しく設定されているか確認してください。
404 Not FoundPROJECT_SLUG が正しいか確認してください。
Version already exists同じバージョン番号は登録できません。新しいバージョン番号を使用してください。
ファイルを取得できないGitHub ReleaseにJARファイルが添付されていることを確認してください。
gh-actions.1785678881.txt.gz · 最終更新: by admin