静的サイトのGitLab Pagesデプロイを作成する
- プラン: Free、Premium、Ultimate
- 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated
GitLab Pagesデプロイを作成して、静的サイトまたはフレームワークをGitLabでホストされるウェブサイトに変換します。段階的なフォームを使用して、GitLabは以下を行います。
- プロジェクト設定に基づいて、カスタムのCI/CD設定を生成します。
- GitLab Pagesデプロイに合わせて設定された
.gitlab-ci.ymlファイルを作成します。 - レビューのために、マージリクエストによって変更を送信します。
- マージリクエストがコミットされると、ウェブサイトを自動的にデプロイします。
このガイドでは、Pages UIを使用して、静的サイトまたはフレームワークベースのアプリケーションをデプロイする方法について説明します。
前提条件
アプリは
publicフォルダーにファイルを出力する必要があります。ビルドパイプライン中にこのフォルダーを作成する場合、Gitにコミットする必要はありません。このステップは重要です。ファイルがルートレベルの
publicフォルダーに確実に配置されるようにしてください。次のいずれかのプロジェクトが必要です。
プロジェクトに対してGitLab Pagesが有効になっている必要があります(有効にするには、設定 > 一般に移動し、可視性、プロジェクトの機能、権限を展開して、Pages切替をオンにします。)
Pagesのデプロイを作成する
セットアップを完了してGitLab Pagesデプロイを生成するには:
上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
デプロイ > Pagesを選択します。
Pagesを始めるフォームが表示されます。このフォームを利用できない場合は、トラブルシューティングを参照してください。
ステップ1では、イメージ名を入力します。Pagesでデプロイするカスタムフォルダを設定することもできます。
次へを選択します。
ステップ2で、インストール手順を入力します。フレームワークのビルドプロセスで、用意されているビルドコマンドのいずれかが不要な場合は、次のいずれかを行います。
- 次へを選択して、ステップをスキップします。
- そのステップのボイラープレートを
.gitlab-ci.ymlファイルに組み込む場合は、:(bashの「何もしない」コマンド)を入力します。
次へを選択します。
ステップ3で、アプリケーションのビルド方法を示すスクリプトを入力します。
次へを選択します。
オプション。必要に応じて、生成された
.gitlab-ci.ymlファイルを編集します。ステップ4で、コミットメッセージを追加し、コミットを選択します。このコミットにより、最初のGitLab Pagesデプロイがトリガーされます。
実行中のパイプラインを表示するには、ビルド > パイプラインに移動します。パイプラインが成功すると、Pagesサイトはデプロイされ、アクセス可能になります。
デプロイ中に作成されたアーティファクトを表示するには、ジョブを表示し、右側のアーティファクトをダウンロードを選択します。
デプロイURLを表示
パイプラインが正常に完了した後:
- 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
- デプロイ > Pagesを選択します。
- デプロイで、アクティブなデプロイURLを表示できます。
- デプロイされたGitLab Pagesサイトにアクセスするには、URLを選択してください。
パイプラインが完了してからサイトが利用可能になるまで、数分かかる場合があります。
トラブルシューティング
Get Started with Pagesフォームを利用できない場合
次の場合、Get Started with Pagesフォームは利用できません。
- 以前にGitLab Pagesサイトをデプロイした。
- 少なくとも1回、フォームから
.gitlab-ci.ymlをコミットした。
この問題を解決するには:
- メッセージPagesのパイプラインの完了を待っていますが表示された場合は、最初から実行を選択してフォームを再度開始します。
- プロジェクトで以前にGitLab Pagesが正常にデプロイされた場合は、
.gitlab-ci.ymlファイルを手動で更新します。