Cloudflareでリポジトリと同期できない…原因が分からずアホの様に詰んだ話…

「無料プランだし、とりあえず申し込んでみるか」という軽い気持ちが、まさかここまでの遠回りにつながるとは思いませんでした。今回は、Cloudflareの無料プランに申し込み、Gitとの連携を試したところで起きた、なんとも情けない失敗談です。

同じようにCloudflareとGitの連携をこれから試そうとしている方や、原因不明のエラーに悩んでいる方の参考になればと思い、顛末と教訓をまとめておきます。

そもそも何をしようとしていたのか

これまでCloudflareを使ったことがなかったため、まずは無料プランに申し込みました。せっかくなので、GitのリポジトリとCloudflareを連携させて、コードをクローンする形で公開まで持っていこうと考えたのが始まりです。

しかし、ここで大きな落とし穴がありました。リポジトリを作成しただけで満足してしまい、その中身をまったく用意していなかったのです。

エラーが出た本当の原因

Cloudflare側で同期やクローンの設定を実行しても、エラーが出るばかりで、何が悪いのかまったく見当がつきませんでした。設定画面を何度見直しても、それらしい原因は見つかりません。

落ち着いて自分の作業を振り返ってみると、原因はGitの基本中の基本、初期化とアップロードの工程を丸ごと飛ばしていたことにありました。下の表は、本来必要だった作業と、実際にやっていた作業を比較したものです。

要するに、Cloudflareに連携する肝心のリポジトリが空っぽだったため、何を同期しようとしても失敗し続けていた、というだけの話でした。Cloudflare側にもGit側にも問題はなく、単純に自分の作業が途中で止まっていただけだったのです。

同じ失敗をしないためのチェックポイント

今回の反省を踏まえて、外部サービスとGitリポジトリを連携する前に確認しておきたいポイントを整理しました。連携作業を始める前に、一度チェックしてみてください。

• リポジトリを作成しただけで満足していないか
• ローカルまたはリモートで git init を実行しているか
• 連携したいファイルを git add できているか
• git commit でファイルの変更を確定させているか
• git push でリモートリポジトリに反映できているか
• 連携先サービスの設定画面で、対象ブランチやリポジトリ名を正しく選べているか

特に無料プランやお試しで使い始めるサービスほど、「とりあえず動くだろう」と設定を急ぎがちです。しかし、基本の手順を1つ飛ばすだけで、原因究明に余計な時間がかかってしまうことがよく分かりました。

まとめ

今回の一件は、Cloudflareの無料プランでGit連携を試みた際に、リポジトリの中身を用意しないまま同期設定を実行してしまい、エラーの原因が分からず悩んでしまったという話でした。原因は非常にシンプルで、git init・add・commit・pushという基本の工程を丸ごと飛ばしていたことにありました。

無料だからといって設定を雑にすると、結果的にその何倍もの時間を原因究明に費やすことになりかねません。これから外部サービスとGitを連携する際は、まず自分のリポジトリに中身がきちんと存在しているかを確認してから、連携設定を進めることをおすすめします。

※ちなみに、ダミーのindexファイル１つpushしたら、問題なく涙出ました…。w