---
title: KurocoFrontにファイルが反映されないのですが、何をチェックすればよいですか？
description: KurocoFrontへのファイルの反映は、基本的にGitHub Actionsを利用します。KurocoFrontへのファイルの反映がされない理由として、主に想定されるパターンは以下になります。
category: trouble
---

import StructuredDataFaqs from '@site/src/components/StructuredDataFaqs';

<StructuredDataFaqs faqs={[
    { question: "KurocoFrontにファイルが反映されないのですが、何をチェックすればよいですか？", answer: "KurocoFrontへのファイルの反映は、現在はGitHubからのみとなっております。KurocoFrontへのファイルの反映がされない理由として、主に想定されるパターンは以下になります。" }
]} />

KurocoFrontへのファイルの反映は、基本的にGitHub Actionsを利用します。 

:::info
まだデプロイの作業を実施していない場合は[Kurocoビギナーズガイド](/ja/docs/tutorials/beginners-guide/)を参考にデプロイをしてください。  
:::

KurocoFrontへのファイルの反映がされない理由として、主に想定されるパターンは以下になります。  

- [GitHub Actionsでの.github/workflows配下のYAMLファイルの記述が間違っている](#github-actionsでのgithubworkflows配下のyamlファイルの記述が間違っている場合)
- [公開ディレクトリのルートにkuroco_front.jsonが存在しない](#公開ディレクトリのルートにkuroco_frontjsonが存在しない場合)
- [GitHub Actionsでのビルドに失敗している](#github-actionsでのビルドに失敗している場合)
- [GitHub Actionsでのビルドやデプロイプロセスで時間がかかっている](#github-actionsでのビルドやkurocofrontへのデプロイプロセスで時間がかかっている場合)
- [デプロイするファイルが重くて、デプロイする処理でエラーになっている](#デプロイするファイルが重くて、デプロイする処理でエラーになっている)
- [CDNのキャッシュが正常にクリアされていない](#cdnのキャッシュが正常にクリアされていない)

## GitHub Actionsでの.github/workflows配下のYAMLファイルの記述が間違っている場合
[GitHub](/ja/docs/management/github/)のページにある.github/workflows配下のYAMLファイルのサンプルの内容と現在の設定の比較・確認をしてください。  

## 公開ディレクトリのルートにkuroco_front.jsonが存在しない場合
[kuroco_front.jsonとは何ですか？](/ja/docs/faq/what-is-kuroco_front_json/)を参考に公開ディレクトリのルートにkuroco_front.jsonを設置してください。  
リポジトリのルートではなく、distなどの出力フォルダのルートに配置されるように設定をしてください。

実際に公開ディレクトリのルートにkuroco_front.jsonがあるかはGitHub ActionsのArtifactsのZipファイルをダウンロードして解凍してご確認いただくことができます。  

## GitHub Actionsでのビルドに失敗している場合
GitHub Actionsの実行ログを確認して、問題点を発見してください。  
ビルド後の成果物をArtifactsのところからダウンロードして確認していただいて、想定されたビルド成果物かどうかのチェックもお願いいたします。  

:::info
GitHub Actionsの実行ログの確認方法は、[GitHub docs -> ワークフロー実行ログを使用する](https://docs.github.com/ja/actions/managing-workflow-runs/using-workflow-run-logs)をご確認ください。
:::

## GitHub ActionsでのビルドやKurocoFrontへのデプロイプロセスで時間がかかっている場合
GitHub Actionsの実行履歴からGitHub Actionsの実行時間を確認してください。KurocoFrontへのデプロイプロセスはArtifactsのサイズによりますが、30秒〜数分程度が想定されます。  

:::info
GitHub Actionsの実行履歴は、[GitHub docs -> ワークフロー実行の履歴を表示する](https://docs.github.com/ja/actions/managing-workflow-runs/viewing-workflow-run-history)をご確認ください。
:::

## デプロイするファイルが重くて、デプロイする処理でエラーになっている
KurocoFrontへのデプロイプロセスではGitHub ActionsのArtifactsを利用しています。  
300MBを超えるArtifactsだとGitHubからのダウンロードスピードの関係でエラーになる場合があります。
現在は、エラーログ等で確認できるようになっておりません。  

GitHub Actionsのプロセス終了後10分以内にデプロイが確認できない場合、Artifactsのダウンロードに失敗している可能性が高いです。
`Re-run jobs`で再実行してください。   

:::info
[GitHub docs -> ワークフローの成果物をダウンロードする](https://docs.github.com/ja/actions/managing-workflow-runs/downloading-workflow-artifacts)
:::

## CDNのキャッシュが正常にクリアされていない
KurocoFrontで利用しているコミットハッシュを確認できますので、どのコミットハッシュのArtifactsがデプロイされているか確認をお願いします。

:::info
[KurocoFrontでどのハッシュが利用されているかの確認方法を教えてください](/ja/docs/faq/how-do-i-verify-the-hash-responses-used-by-kurocofront/)
:::

:::info
[CDNにキャッシュされたレスポンスかどうかの確認方法を教えてください](/ja/docs/faq/how-do-i-verify-responses-in-the-cdn-cache/)
:::