path: root/content/posts/2022-10-28/setup-server-for-this-site.xml

<?xml version="1.0" encoding="UTF-8"?>
<article xmlns="http://docbook.org/ns/docbook" xmlns:xl="http://www.w3.org/1999/xlink" version="5.0">
  <info>
    <title>【備忘録】 このサイト用の VPS をセットアップしたときのメモ</title>
    <abstract>
      GitHub Pages でホストしていたこのサイトを VPS へ移行したので、そのときにやったことのメモ。99 % 自分用。
    </abstract>
    <keywordset>
      <keyword>note-to-self</keyword>
    </keywordset>
    <revhistory>
      <revision>
        <date>2022-10-28</date>
        <revremark>公開</revremark>
      </revision>
    </revhistory>
  </info>
  <section xml:id="intro">
    <title>はじめに</title>
    <simpara>
      これまでこの blog は GitHub Pages でホストしていたのだが、先日 VPS に移行した。
      そのときにおこなったサーバのセットアップ作業を書き残しておく。
      99 % 自分用の備忘録。別のベンダに移したりしたくなったら見に来る。
    </simpara>
    <simpara>
      未来の自分へ: 特に自動化してないので、せいぜい苦しんでくれ。
    </simpara>
  </section>
  <section xml:id="vps">
    <title>VPS</title>
    <simpara>
      <link xl:href="https://vps.sakura.ad.jp/">さくらの VPS</link> の 2 GB プラン。
      そこまで真面目に選定していないので、困ったら移動するかも。
    </simpara>
  </section>
  <section xml:id="preparation">
    <title>事前準備</title>
    <section xml:id="preparation--hostname">
      <title>サーバのホスト名を決める</title>
      <simpara>
        モチベーションが上がるという効能がある。今回は藤原定家から取って <literal>teika</literal> にした。
        たいていいつも源氏物語の帖か小倉百人一首の歌人から選んでいる。
      </simpara>
    </section>
    <section xml:id="preparation--ssh-key">
      <title>SSH の鍵生成</title>
      <simpara>
        ローカルマシンで鍵を生成する。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/teika.key
        $ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github2teika.key
        ]]>
      </programlisting>
      <simpara>
        <literal>teika.key</literal> はローカルからサーバへの接続用、<literal>github2teika.key</literal> は、
        GitHub Actions からサーバへのデプロイ用。
      </simpara>
    </section>
    <section xml:id="preparation--ssh-config">
      <title>SSH の設定</title>
      <simpara>
        <literal>.ssh/config</literal> に設定しておく。
      </simpara>
      <programlisting language="ssh_config" linenumbering="unnumbered">
        <![CDATA[
        Host teika
        HostName **********
        User **********
        Port **********
        IdentityFile ~/.ssh/teika.key
        ]]>
      </programlisting>
    </section>
  </section>
  <section xml:id="basic-setup">
    <title>基本のセットアップ</title>
    <section xml:id="basic-setup--login">
      <title>SSH 接続</title>
      <simpara>
        VPS 契約時に設定した管理者ユーザとパスワードを使ってログインする。
      </simpara>
    </section>
    <section xml:id="basic-setup--user">
      <title>ユーザを作成する</title>
      <simpara>
        管理者ユーザで作業すると危ないので、メインで使うユーザを作成する。
        <literal>sudo</literal> グループに追加して <literal>sudo</literal> できるようにし、<literal>su</literal> で切り替え。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo adduser **********
        $ sudo adduser ********** sudo
        $ su **********
        $ cd
        ]]>
      </programlisting>
    </section>
    <section xml:id="basic-setup--hostname">
      <title>ホスト名を変える</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo hostname teika
        ]]>
      </programlisting>
    </section>
    <section xml:id="basic-setup--public-key">
      <title>公開鍵を置く</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ mkdir ~/.ssh
        $ chmod 700 ~/.ssh
        $ vi ~/.ssh/authorized_keys
        ]]>
      </programlisting>
      <simpara>
        <literal>authorized_keys</literal> には、ローカルで生成した <literal>~/.ssh/teika.key.pub</literal> と
        <literal>~/.ssh/github2teika.key.pub</literal> の内容をコピーする。
      </simpara>
    </section>
    <section xml:id="basic-setup--ssh-config">
      <title>SSH の設定</title>
      <simpara>
        SSH の設定を変更し、少しでも安全にしておく。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
        $ sudo vi /etc/ssh/sshd_config
        ]]>
      </programlisting>
      <itemizedlist>
        <listitem><literal>Port</literal> を変更</listitem>
        <listitem><literal>PermitRootLogin</literal> を <literal>no</literal> に</listitem>
        <listitem><literal>PasswordAuthentication</literal> を <literal>no</literal> に</listitem>
      </itemizedlist>
      <simpara>
        そして設定を反映。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo systemctl restart sshd
        $ sudo systemctl status sshd
        ]]>
      </programlisting>
    </section>
    <section xml:id="basic-setup--ssh-connect">
      <title>SSH で接続確認</title>
      <simpara>
        今の SSH セッションは閉じずに、ターミナルを別途開いて疎通確認する。
        セッションを閉じてしまうと、SSH の設定に不備があった場合に締め出しをくらう。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ ssh teika
        ]]>
      </programlisting>
    </section>
    <section xml:id="basic-setup--close-ports">
      <title>ポートの遮断</title>
      <simpara>
        デフォルトの 22 番を閉じ、設定したポートだけ空ける。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo ufw deny ssh
        $ sudo ufw allow *******
        $ sudo ufw enable
        $ sudo ufw reload
        $ sudo ufw status
        ]]>
      </programlisting>
      <simpara>
        ここでもう一度 SSH の接続確認を挟む。
      </simpara>
    </section>
    <section xml:id="basic-setup--ssh-key-for-github">
      <title>GitHub 用の SSH 鍵</title>
      <simpara>
        GitHub に置いてある private リポジトリをサーバから clone したいので、SSH 鍵を生成して置いておく。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ ssh-keygen -t ed25519 -b 521 -f ~/.ssh/github.key
        $ cat ~/.ssh/github.key.pub
        ]]>
      </programlisting>
      <simpara>
        <link xl:href="https://github.com/settings/ssh">GitHub の設定画面</link> から、この公開鍵を追加する。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ vi ~/.ssh/config
        ]]>
      </programlisting>
      <simpara>
        設定はこう。
      </simpara>
      <programlisting language="ssh_config" linenumbering="unnumbered">
        <![CDATA[
        Host github.com
        HostName github.com
        User git
        IdentityFile ~/.ssh/github.key
        ]]>
      </programlisting>
      <simpara>
        最後に接続できるか確認しておく。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        ssh -T github.com
        ]]>
      </programlisting>
    </section>
    <section xml:id="basic-setup--upgrade-packages">
      <title>パッケージの更新</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo apt update
        $ sudo apt upgrade
        $ sudo apt update
        $ sudo apt upgrade
        $ sudo apt autoremove
        ]]>
      </programlisting>
    </section>
  </section>
  <section xml:id="site-hosting-setup">
    <title>サイトホスティング用のセットアップ</title>
    <section xml:id="site-hosting-setup--dns">
      <title>DNS に IP アドレスを登録する</title>
      <simpara>
        このサーバは固定の IP アドレスがあるので、<literal>A</literal> レコードに直接入れるだけで済んだ。
      </simpara>
    </section>
    <section xml:id="site-hosting-setup--install-softwares">
      <title>使うソフトウェアのインストール</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo apt install docker docker-compose git make
        ]]>
      </programlisting>
    </section>
    <section xml:id="site-hosting-setup--docker">
      <title>メインユーザが Docker を使えるように</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        sudo adduser ********** docker
        ]]>
      </programlisting>
    </section>
    <section xml:id="site-hosting-setup--open-http-ports">
      <title>HTTP/HTTPS を通す</title>
      <simpara>
        80 番と 443 番を空ける。
      </simpara>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ sudo ufw allow 80/tcp
        $ sudo ufw allow 443/tcp
        $ sudo ufw reload
        $ sudo ufw status
        ]]>
      </programlisting>
    </section>
    <section xml:id="site-hosting-setup--clone-repositories">
      <title>リポジトリのクローン</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ cd
        $ git clone git@github.com:nsfisis/nsfisis.dev.git
        $ cd nsfisis.dev
        $ git submodule update --init
        ]]>
      </programlisting>
    </section>
    <section xml:id="site-hosting-setup--certbot">
      <title>certbot で証明書取得</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ docker-compose up -d acme-challenge
        $ make setup
        ]]>
      </programlisting>
    </section>
    <section xml:id="site-hosting-setup--run-server">
      <title>サーバを稼動させる</title>
      <programlisting language="shell-session" linenumbering="unnumbered">
        <![CDATA[
        $ make serve
        ]]>
      </programlisting>
    </section>
  </section>
  <section xml:id="outro">
    <title>感想</title>
    <simpara>
      (業務でなく) 個人だと数年ぶりのサーバセットアップで、これだけでも割と時間を食ってしまった。
      とはいえ式年遷宮は楽しいので、これからも定期的にやっていきたい。
      コンテナデプロイにしたい気持ちもあるのだが、色々実験したい関係上、本物のサーバも欲しくはある。
      次の式年遷宮では、手順の一部だけでも自動化したいところ。
    </simpara>
  </section>
</article>