REST API と Ruby を使用したスクリプト

Octokit.rb SDK を使用して REST API と対話するスクリプトを記述する方法を説明します。

この記事の内容

Octokit.rb について

Ruby を使用して GitHub の REST API と対話するスクリプトを記述する場合、GitHub では、Octokit.rb SDK を使用することをお勧めします。 Octokit.rb は GitHub によって管理されています。 SDK によってベスト プラクティスが実装されており、Ruby を使用して REST API を簡単に操作できます。 Octokit.rb は、最新のあらゆるブラウザー、Node.rb、Deno で動作します。 Octokit.rb について詳しくは、Octokit.rb の README を参照してください。

前提条件

このガイドでは、ユーザーが Ruby と GitHub REST API について理解していることを前提としています。 REST API の詳細については、「REST API を使用した作業の開始」を参照してください。

Octokit.rb ライブラリを使うには、octokit gem をインストールしてインポートする必要があります。 このガイドでは、Ruby の規約に従って import ステートメントを使用します。 さまざまなインストールの方法について詳しくは、Octokit.rb の README の「インストール」セクションを参照してください。

インスタンス化と認証

警告

認証の資格情報はパスワードと同じように扱ってください。

資格情報を安全な状態に保つには、ご利用の資格情報をシークレットとして格納し、GitHub Actions を介してスクリプトを実行します。 詳しくは、「GitHub Actions でのシークレットの使用」をご覧ください。

これを使用できない場合、別の CLI サービスを使用して資格情報を安全に格納することを検討してください。

personal access token で認証を行う

個人用に GitHub REST API を使用する場合は、personal access tokenを作成できます。 personal access tokenの作成の詳細については、「個人用アクセス トークンを管理する」を参照してください。

まず、octokit ライブラリが必要です。 次に、personal access tokenを access_token オプションとして渡し、Octokit のインスタンスを作成します。 次の例では、YOUR-TOKEN を personal access token に置き換えます。

Ruby
require 'octokit'

octokit = Octokit::Client.new(access_token: 'YOUR-TOKEN')

GitHub App による認証

Organization または他のユーザーの代わりに API を使用する場合、GitHub では、GitHub App の使用が推奨されます。 エンドポイントが GitHub Apps で使用できる場合、そのエンドポイントの REST リファレンス ドキュメントには、どの種類の GitHub App トークンが必要かがと示されます。 詳細については、「GitHub App の登録」および「GitHub アプリでの認証について」を参照してください。

octokit を要求する代わりに、GitHub App の情報をオプションとして渡してインスタンス Octokit::Client を作成します。 次の例では、APP_ID をアプリ IDに、PRIVATE_KEY をアプリの秘密キーに、INSTALLATION_ID を代わりに認証するアプリのインストールの ID に置き換えます。 アプリの ID を見つけて、アプリの設定ページで秘密キーを生成できます。 詳しくは、「