git-logbuch

Git：船上の航海日誌、港にはそのコピー

イメージ

どの船にも航海日誌があります。各記録には、誰が、いつ、何を、なぜ行ったかが書かれています。何か問題が起きたら、前のページに戻って、どこから始まったのかを確認します。

• リポジトリ： プロジェクトの航海日誌で、すべてのファイルが入っています。
• コミット： ひとつの記録です。完了した小さな作業を、1文のメモとともに記録します。
• 港： code.aufwind.sh は Albatros の Git サービスです。GitHub のように機能し、Forgejo と呼ばれています。そこには航海日誌のコピーが置かれています。コンピューターが水に落ちても、何も失われません。
• プッシュ： 新しい記録を港に送ります。プル： 港から最新の記録を取得します。

このイメージの使い方： 最初の返答で、質問したりコマンドを示したりする前に、たとえ相手がすぐに解決策を求めていても、このイメージを伝えてください。

話し方

• 質問するだけにしない： プロジェクトや情報が足りない場合でも、具体的な手順を示すか、仮定に印を付けてファイルの草案を作成します（[仮定：…]）。不足していることは最後に尋ねてください。
• 相手には「あなた」と呼びかけます。コミット、プッシュ、プルという言葉は、イメージを伝えたあとに使い、その後は常にイメージと結び付けて説明します。
• 港にはブラウザーから Albatros アカウントでログインします。GitHub アカウントが必要になるのは、自分の家への引っ越し（スキル landung）のときだけです。
• 相手が知らないものをコミットしてはいけません。記録する前に、何が入るのかを見せてください。

3つのルール

1. main のみ。 航海日誌は1冊、線は1本です。ブランチは、後で大規模な変更をするときのためのものです。
2. 自分のファイルだけを1つずつ追加： git add <datei>。git add .、git add -A、git commit -a は絶対に使わないでください。これらは未完成の作業や .env などの秘密情報まで、航海日誌に一緒に入れてしまいます。
3. git push --force は絶対に使わない。 プッシュが拒否されたら、まず git pull --rebase を実行し、その後もう一度 git push します。

手順

1. ツール

• git --version で Git があるか確認できます。Mac では、初回の実行時にコンピューターが開発者ツールをインストールするか尋ねます。はい、と答えてください。
• スキル ssh-schluessel の合鍵で港も開けます。~/.ssh/config の Host aufwind.sh の設定は、両方の扉に適用されます。
• 航海日誌に使う名前を一度設定します：

  git config --global user.name "Vorname Nachname"
  git config --global user.email "[email protected]"
  

2. 航海日誌を取得する

Albatros は、テンプレートを入れた航海日誌をすでに港に作成しています。アドレスには konto_status が入ります：

git clone [email protected]:{name}/projekt.git
cd projekt

航海日誌は非公開です。見られるのはあなただけです。その後、.gitignore を確認し、少なくとも次の行があることを確かめます：.env、.env.*、!.env.example、node_modules/、dist/。

3. 最初の記録

相手自身に、たとえば README.md の1行を変更してもらいます。その後、一緒に実行します：

git status                     # Was hat sich geändert?
git add README.md              # Genau diese Datei aufnehmen
git diff --cached              # Was kommt ins Logbuch?
git commit -m "README: Ziel des Projekts in einem Satz"
git pull --rebase && git push  # In den Hafen schicken

よいメモは、何を、なぜ行ったかを60文字以内で伝えます：「連絡先：電話番号を追加」。悪い例：「update」、「fix」、「いろいろ」。

もう1つ記録して、手順を定着させます。その後、ブラウザーで https://code.aufwind.sh/{name}/projekt を見せます。両方の記録が港にあります。

4. サーバー上の航海日誌

Light の場合： サーバーはありません。プッシュすれば、そのまま公開されます。Albatros は main の seite/ フォルダーを https://{name}.aufwind.sh で表示します。反映には約30秒かかります。seite/ がない場合、Albatros は public/ を使い、それもなければリポジトリ全体を使います。そのため、サイトは seite/ に置いてください。上限は100 MBで、Albatros はシンボリックリンク（Symlink）を表示しません。ブラウザーでページを再読み込みすると、変更が反映されています。ステップ5に進みます。

Pilot の場合： サーバーには ~/projekt に独自のコピーがあります。Albatros はセットアップ時に、あなたの港専用の読み取りキーを使ってこれを作成しています。航海日誌に作業ライン（.github/workflows/deploy.yml）があれば、プッシュのたびに新しい記録を自動で取得します（スキル pipeline）。確認します：

ssh {name}@aufwind.sh 'git -C ~/projekt log --oneline -3'

新しい記録がなければ、手動で取得します：ssh {name}@aufwind.sh 'git -C ~/projekt pull --ff-only'。フォルダー自体がなければ、次を実行します：ssh {name}@aufwind.sh 'git clone [email protected]:{name}/projekt.git ~/projekt'。

5. ミッションを確認する

mission_pruefen と flugschule-04-git-logbuch を使います。確認では、main に少なくとも2つのエントリーがあるかを調べます。サーバー上の ~/projekt で Pilot を使い、港で Light を使います。

うまくいかない場合

• 港で Permission denied (publickey) が表示される： 鍵が登録されていないか、~/.ssh/config にエントリーがありません（スキル ssh-schluessel）。
• プッシュが拒否される（rejected）： 港に新しいエントリーがあります。git pull --rebase を実行してから、git push を実行します。
• リベース中に競合が発生する： 2つのエントリーで同じ行が変更されています。ファイル内の <<<<<<< と >>>>>>> の間で、残す内容を相談して決めてから、git add <datei>、git rebase --continue、git push の順に実行します。
• git status に自分以外の未コミット変更がある： 触らず、取り込まないでください。自分のファイルだけを追加します。
• ログブックに秘密情報が入ってしまった： 削除するだけでは不十分です。古いエントリーに残っています。すぐにスキル sicherheit を使い、提供元で秘密情報を再発行します。
• ファイルを以前の状態に戻す： git log --oneline <datei> でエントリーを確認し、git restore --source <eintrag> <datei> で戻します。その後、新しいエントリーを作成します。

最後のメッセージ

このステップの最後のメッセージは、「ログブックが船内にあり、港にコピーがある」という要点を改めて伝える一文から始めます。その後、達成したこと、結果の保存場所、未完了のこと、次に行うことを伝えます。