メインコンテンツへスキップ
見出し画像

Claude Code 本番のサーバーへ鍵で入り、照らしてから置くセット|鍵認証・接続名・git archiveの照合・アプリの起動

    借りたサーバーで自分のアプリを動かしていると、直したファイルを本番へ届ける作業が、何度も回ってきます。最初のうちは、パスワードでログインして手で上書きする形でも用は足ります。けれど、Claude Codeに読み取りや配置の下ごしらえを頼むようになると、入り方と置き方を、毎回同じ形に決めておきたくなります。

    このセットは、本番のサーバーとの付き合い方を「パスワードを使わずに鍵で入る → 自動の作業向けの接続名を作る → 送るファイルを一覧で決めて照らす → 照合が合ってから置く → アプリが起動して応えるのを見る」の順に、Claude Codeと進めるためのものです。サーバーの設定を書き換えるのも、ファイルを置くのも、自分の手で行います。Claude Codeには、読むだけのコマンドの案、手元で試す仕組み、設定の案、貼った結果の読み取りを頼みます。

    4つのやり方の考え方とコードは、無料で公開している次のWeb記事にまとめてあります。

    このnoteの役目は、4本を「入る・届ける・動かす」の1本の流れに並べ、段ごとに何を確かめてから次へ進むかを決め、Claude Codeに渡せる形にまとめることです。

    このセットを作ったきっかけ

    このサイトのアプリも、借りたサーバーの上で動いています。Claude Codeと一緒に記事を直しては本番へ届ける作業を続けるうちに、入り方と置き方の小さな違いで、作業が進まなくなる場面に何度も出会いました。

    • Claude Codeにはパスワードを扱わせないと決め、本番への接続は鍵認証にした

    • 本番用の接続名には、BatchModeとIdentitiesOnlyを付けた

    • 設定ファイルの先頭に見えない印(BOM)が付いていて、ある環境のsshはその設定を読めなかった

    • 作業PCを再起動した日には、鍵を預かる仕組み(ssh-agent)が止まっていて、鍵での接続が断られた

    • zipで送った日には、起動用のスクリプトの実行の権限が外れていた

    • Web記事の検証では、Gunicornを既定のワーカーのままFastAPIに使うと、起動はするのに要求が500で返ってきた

    • 同じく、sshdの設定で後から読むファイルに書いたnoは、先に読んだファイルのyesに負けた

    どれも、入る前・送る前・置く前に同じ形で確かめていれば、すぐに切り分けられるものでした。今は、git archiveで一覧のファイルだけをまとめたtarを作り、送った後も中身のハッシュ値が一致してから置く形にしています。このセットでは、その確かめを、段の順番に組み込みました。

    本番へ入る・置くときに見落としやすいこと

    • 鍵で入れることを試す前に、パスワードでのログインを止めてしまう

    • 設定を変えたときに、ログインしたままの画面を残していない

    • 設定の項目が、どのファイルのどの値で効いているのかを見ていない

    • 送るファイルを、その場の記憶で選んでいる

    • 届いた後の中身を照らさずに、上書きしている

    • 置いた後の権限や、起動の形が前と変わっていないかを見ていない

    Web記事との違い

    • 無料の4本のWeb記事: 鍵認証への切り替え・接続名・git archiveでの配置・FastAPIの起動を、1本ずつ扱っています。考え方、コード、手元で試した結果、判断の目安、つまずきやすい所まで読めます。1つのやり方だけが目当てなら、Web記事で足ります

    • このセット(有料): 4本を、入る・届ける・動かすの1本の流れに並べ直しました。段ごとの依頼文10本と、うまくいかない時の6本を用意しました。ほかに、{ } の値の見本が12個、場面ごとの点検の一覧、区切りの目安があります

    コマンドやスクリプトの中身はWeb記事の側に置き、このnoteには写していません。中身を確かめたいときは、記事のページを開いてください。

    このセットで進められること

    • 今のSSHの設定と、アプリのファイルの置き方を、何も変えずに書き出してもらう

    • 自分で鍵を作って登録し、鍵だけで入れることを確かめてから、パスワードでのログインを止める

    • 自動の作業に使う接続名を作り、効いている値を読み出して確かめる

    • 本番へ送るファイルを一覧で決め、今の本番の中身が前の版と同じかを照らす

    • 一覧のファイルだけのtarと指紋の一覧を作り、届いた後に照合してから、控えを取って置く

    • アプリのサーバーの起動の形を手元で確かめ、入れ替えた後の応答を見て、次回の手順をメモにする

    含まれるもの・含まれないもの

    含まれるもの:

    • STEPごとの依頼文が10本(1段に1本)。扱うのは、今の入り方と置き方の書き出し・鍵の作成と登録・鍵だけで入る確かめ・パスワードを止める設定の案・接続名・置くファイルの一覧と本番の照合・tarと指紋の一覧・届いた後の照合と配置・アプリの起動の形・入れ替えた後の確かめと手順のメモ

    • うまくいかない時の依頼文6本。鍵の接続が断られる・止めたはずのパスワードを聞かれる・接続名の設定が効かない・届いたファイルの照合が合わない・置いた後に起動のスクリプトが動かない・入れ替えた後にアプリが応えない

    • { } に入れる値の見本12個と、段ごとの打つ場所と残るものの印

    • 点検の一覧18項目(鍵を作る前から入れ替えた後までの6つの場面)

    • 区切ってよいかの目安5つと、架空の小さなパン屋の予約アプリで通した例

    どの依頼文も独立した枠に入れてあるので、枠ごとコピーして、そのままClaude Codeへ渡せます。

    含まれないもの:

    • サーバーを借りる手続き、OSを入れる作業、ファイアウォールの設定

    • Apacheのリバースプロキシの設定そのもの(既刊の「リバースプロキシで複数のアプリを公開する実践セット」が受け持ちます)

    • アプリを常駐させる仕組みの選び方(既刊の常駐と監視のセットが受け持ちます)

    • DBの変更とバックアップの取り方(既刊のPostgreSQLの変更のセットと、バックアップと復元のセットが受け持ちます)

    • レンタルサーバーのように、SSHの設定を会社の側が決めている環境での変更

    対象の読者と注意点

    VPSのような自分で借りたサーバーで、Pythonのアプリを動かしていて、本番へ入る方法とファイルを届ける方法を、自分で確かめられる形に整えたい人に向けたセットです。使う道具は、作業PCのClaude Code、作業PCのターミナル、サーバーへのSSH、アプリのGitのリポジトリの4つです。

    • どの依頼文も、ファイルを作る前と、設定やコマンドの案を出した時点で一度区切る作りです。最後の行にある「確認を待ってください」のような文は、消さずに渡してください

    • sshdの設定を書き換えて読み込み直すのも、本番にファイルを置くのも、自分です。鍵を作ってパスフレーズを決めるのも、自分です

    • 秘密鍵の中身、パスフレーズ、パスワード、サーバーの本当のアドレスは、Claude Codeに貼りません。貼る前に伏せます

    • パスワードでのログインを止める日、送るファイル、戻すかどうかの3つは、自分で決めます

    • 依頼文の書き方は、4本のWeb記事のために原文で確かめたOpenSSH・Git・GNU coreutils・FastAPI・Uvicorn・Gunicornの公式の資料に沿っています

    ここから先は、購入した方だけが読める部分です。最初に進め方と { } の値の見本、段ごとの印を並べ、続けて10段の依頼文、点検の一覧、うまくいかない時の6本、区切りの目安、架空のパン屋の例を置いています。

    あなたへのおすすめ