# GitHubを使ってポータルを設定

Talend Cloud API Designerでは、GitHubリポジトリーを自動的に設定し、API Portalの設定を入力して、APIドキュメンテーションを含めることができます。 異なるソースコントロールプロバイダーを使用する場合は、[別のGitプロバイダーでポータルを設定](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Cloud/configuring-api-portal-with-another-git-provider)をご覧ください。

## 手順

1. Talend Cloud API Designerを開き、API Portalタブに移動します。
2. [Configure the API Portal] (API Portalを設定)をクリックします。
3. GitHubリポジトリーを接続します。
   * GitHubアカウントをTalend Cloud API Designerにまだリンクしていない場合は、[Link your GitHub account] (GitHubアカウントをリンク)をクリックして、Talendにリポジトリーへのアクセスを許可します。
   * アカウントがリンク済みの場合は、[Select a GitHub repository] (GitHubリポジトリーを選択)をクリックします。

   ![API Portal設定ページ。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/portal_onboarding.png)
4. 使用するリポジトリーを選択します。
   * 新しいリポジトリーを作成するには、[Create a new GitHub repository] (新しいGitHubリポジトリーを作成)を選択し、オーナーを選択して名前を入力します。
   * 既存のリポジトリーを使用するには、[Use an existing GitHub repository] (既存のGitHubリポジトリーを使用)を選択し、所有者、リポジトリー、および使用するブランチを選択します。

   ![\[GitHubリポジトリーを選択\]ダイアログボックス。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/portal_onboarding_2.png)
5. [Create] (作成)をクリックします。
6. オプション: GitHub Pagesにポータルを自動で公開したい場合は、[Enable GitHub Pages] (GitHub Pagesを有効化)をクリックし、GitHubワークフロー権限を付与します。

   リポジトリーでGitHub Actionsを自動で設定するには、この権限が必要です。後で、API Portal設定からまたは、手動でリポジトリーからGitHubページ有効化できます。詳細は、[GitHub Pagesでポータルをデプロイ](https://help.qlik.com/talend/r/ja-JP/Cloud/api-portal-deployment-guide/github-pages-deployment)をご覧ください。

   情報メモ注: これはリポジトリーに存在するどのGitHubページ設定も上書きします。
7. [Select API Documentation to publish] (公開するAPIドキュメンテーションを選択)をクリックします。

   既存のリポジトリーを使用した場合は選択したブランチ上、またはリポジトリーを新規に作成した場合はmainブランチ上の選択したリポジトリーにAPI Portalテンプレートがコミットされます。公開可能なAPIのリストが表示されます。
8. 公開するAPIの横にある[Publish] (公開)をクリックします。

   ![公開されていないAPIのリストのスクリーンショット。](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Resources/images/configure_portal_03_publish.png)

## タスクの結果

API Portal リポジトリーが設定され、自身の最初のAPIが公開されます。これで、ポータルをカスタマイズしてデプロイすることができます。

### このセクション内

* [API Portalリポジトリー](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Cloud/api-portal-repository)
* [APIドキュメントの管理](https://help.qlik.com/talend/ja-JP/api-designer-user-guide/Cloud/managing-api-documentation)