GitHub
アプリケーションを追加する際には、アカウントからGitサービスとリポジトリを選択する必要があります。GitHubのほか、BitbucketやGitLabから選択することも可能です。
他のGitサービスにリポジトリがある場合は、GitHubにインポートすることで、弊社でホストするアプリケーションに接続することができます。
認証と権限付与
MyKinstaで初めてアプリケーションを追加するときには、Kinstaがアプリケーションのリポジトリにアクセスできるように、Gitサービスへの接続が必要になります。「サービスを追加」ボタンをクリックし、ドロップダウンメニューから「アプリケーション」を選択してください。その後、Gitサービスを選択し、Kinstaとのアカウント接続を行います。
![KinstaをGitHubアカウントと接続する](https://kinsta.com/wp-content/uploads/2023/11/application-connect-git-1024x370.png)
以前にアプリケーションをデプロイして別のGitサービスを接続したことがある場合、アプリケーション追加の際にアプリケーションの詳細情報ステップでGitHubを選択するオプションが表示されます。
![アプリケーション追加の際に、アプリケーションの詳細情報画面でGitHubを選択する](https://kinsta.com/wp-content/uploads/2023/11/application-connect-github-1024x510.png)
GitHubにログインしていない場合は、ログインを行ってください。次のページで、アクセスを承認できるように認証を完了する必要があります。最後のステップとして、GitHubアカウントへのアクセスをKinsta GitHubアプリケーションに許可します。
![KinstaがGitHubアカウントに接続することを許可する](https://kinsta.com/wp-content/uploads/2023/11/application-authorize-mykinsta-github-789x1024.png)
MyKinstaに戻り、アプリケーションの追加とKinsta GitHubアプリケーションのリポジトリへのインストールを行います。
GitHubの権限の編集
「アプリケーションを追加」ポップアップで、「GitHubリポジトリ」フィールドをクリックし、ドロップダウンから「GitHubの権限を編集」を選択します。
![アプリケーションの追加画面でGitHubの権限を編集する](https://kinsta.com/wp-content/uploads/2023/11/application-edit-github-permissions-1024x661.png)
これにより、GitHubアカウントへのKinsta GitHubアプリケーションのインストールが開始されます。複数のアカウントを保有している場合には、インストールに使用するアカウントを選択して続行してください。
![GitHubアカウントにKinsta GitHubアプリケーションをインストールする](https://kinsta.com/wp-content/uploads/2023/11/application-github-install-kinsta-1024x599.png)
次の画面で、このアプリケーションがアクセスできる対象を指定できます。Kinstaはお客様のデータへのアクセスをできるだけ少なくすることを目的としています。そのため、アプリケーションにすべてのリポジトリへのアクセス権を付与しないことをお勧めします。「Only select repositories」をクリックし、デプロイするリポジトリを選択します。
![KinstaにデプロイしたいGitHubのリポジトリを選択する](https://kinsta.com/wp-content/uploads/2023/11/application-select-repos-github.png)
最後に「Save」をクリックすれば完了です。MyKinstaに戻り、「GitHubリポジトリ」のフィールドをクリックすると、許可されたリポジトリが表示されます。
![デプロイするリポジトリを選択する](https://kinsta.com/wp-content/uploads/2023/11/application-select-repository-1024x713.png)
KinstaによるGitHubへのアクセスを取り消す
MyKinstaまたはGitHubから、GitHubアカウントへのKinstaのアクセスを取り消すことができます。
MyKinsta経由でアクセスを削除する
MyKinstaで、自分のユーザー名をクリックし、「ユーザー設定」>「アクセス管理」に進みます。「アプリケーションのアクセス」セクションにあるGitHubアプリケーションの「アクセスを取り消す」をクリックします。
![MyKinstaのアプリケーション画面でGitHubアプリケーションのアクセスを取り消す](https://kinsta.com/wp-content/uploads/2023/11/application-revoke-github-access.png)
GitHub経由でアクセスを削除する
GitHubで、自分のユーザーアバターをクリックし、「Settings」>「Applications」>「Authorized GitHub Apps」に進みます。Kinsta GitHubアプリケーションの「Revoke」をクリックします。
![「Authorized GitHub Apps」画面でKinstaが承認されている状態](https://kinsta.com/wp-content/uploads/2023/11/applications-github-revoke-1024x276.png)
確認ポップアップで「I understand, revoke access」をクリックします。
![KinstaによるGitHubアプリケーションのアクセスを取り消す](https://kinsta.com/wp-content/uploads/2023/11/applications-github-revoke-confirm.png)
その後、MyKinstaで新しいアプリケーションを追加する際には、Kinsta GitHubアプリケーションを認証し、GitHubアカウントに再び接続する操作が必要になります。
GitHubにリポジトリをインポートする
- GitHubで、画面右上の「+」をクリックし、「Import a repository」を選択します。
- 他のGitサービスからリポジトリのURLをコピーし、GitHubの「Your old repository’s clone URL」に貼り付けます。
- GitHubの組織に所属している場合は、リポジトリの「Owner」を選択してください。
- 「Repository name」フィールドにリポジトリ名を入力します。
- プライバシー設定の選択後、「Begin import」をクリックします。
リポジトリをGitHubにインポート - 他のGitサービスのリポジトリが非公開の場合は、プロンプトが表示されたらユーザー名/ログイン名とパスワードを入力し、「Submit」をクリックしてください。
トラブルシューティング
リポジトリの消失(Missing repository)
「アプリケーションの追加」ポップアップでリポジトリが表示されない場合は、Kinsta GitHubアプリケーションの再認証が必要になる可能性があります。これを行うには、上記のようにKinstaとGitHub間のアクセスを削除することから始めてください。
その後、MyKinstaの「アプリケーションを追加」ポップアップ(「サービスを追加」>「アプリケーション」)で、認証の手順を経てKinstaをGitHubアカウントに再び接続します。
名前空間の競合
名前空間の競合は、Gitアカウントが別のMyKinstaアカウントに接続されている場合に表示されます。Gitアカウントは、1つのMyKinstaアカウントにのみ接続可能です。複数のMyKinstaアカウントをお持ちの場合は、それに応じて複数のGitアカウントを使用してください。
このエラーを解決するには、他のMyKinstaアカウントにログインし、弊社のGitHubへのアクセス権を削除する必要があります。