# GitHub Pagesでポータルをデプロイ

GitHub PagesのデプロイメントはTalend Cloud API Designerで直接有効にできますが、リポジトリーを生成した後に手動で行うことも可能です。詳細は、[GitHubのドキュメンテーション](https://docs.github.com/en/github/working-with-github-pages)を参照してください。

## 始める前に

* API Portalリポジトリーを生成済みであること。
* プライベートリポジトリーからGitHub Pagesに公開できGitHubプランがあること。

## 手順

1. GitHubリポジトリーで[Settings] (設定)に移動し、GitHub Pagesセクションまでスクロールダウンします。
2. ソースブランチとしてgh-pagesを、ソースディレクトリーとして/(root)を選択し、[Save] (保存)をクリックします。

   ![GitHub Pagesセクション。](https://help.qlik.com/talend/ja-JP/api-portal-deployment-guide/Resources/images/deploy_to_gh_pages_01_settings.png)
3. mainブランチで/.github/workflows/github-pages.yamlファイルを開き、onエレメントを次のようにアップデートします。
   ```
   on:
     push:
       branches: [ 'main' ]
   ```
4. 変更をコミットします。

## タスクの結果

github-pages.yamlの編集がコミットされると、対応するGitHubアクションが実行されます。これによってmainブランチからのコンテンツがビルドされ、gh-pagesブランチにプッシュされます。このコンテンツはポータルのデプロイに使われます。URLは設定のGitHub Pagesセクションで確認できます。 ![この例では、GitHub Pagesセクションでhttps://company.github.io/api-portal/というURLを利用できます。](https://help.qlik.com/talend/ja-JP/api-portal-deployment-guide/Resources/images/deploy_to_gh_pages_02_url.png)