diff --git a/README.md b/README.md index 2aad44c..23b7b20 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,104 @@ Autoinstall USB Flash Drive イメージをビルドするためのツール群 - **起動すると自動的にストレージをフォーマットします。必要に応じてあらかじめバックアップを取ってください。** - **動作を保証するものではありません。** +## 構成 + +user-data ファイルを編集して行います。 + +### ホスト名・ユーザー名・パスワードの設定 + +user-data ファイルの identity プロパティで指定します。 + +例: + + +```yml +# user-data + identity: + # ホスト名 + hostname: hostname + # ユーザー名 + username: ubuntu + # パスワードのハッシュ値 + password: "$6$iGfCDHv5HM.ATvx2$2jO1Uf1do6mggo5nvbhB4/kEVwV.gAu8yKjGYHjcIHF.NAMFnXjFUtBW0RVPaxIDDe5yfQ4OXlzuwMBcReMAm/" +``` + + +パスワードのハッシュ値は `openssl passwd` コマンドなどで生成します。 + +例: + +```console +$ openssl passwd -6 +Password: +Verifying - Password: +$6$iGfCDHv5HM.ATvx2$2jO1Uf1do6mggo5nvbhB4/kEVwV.gAu8yKjGYHjcIHF.NAMFnXjFUtBW0RVPaxIDDe5yfQ4OXlzuwMBcReMAm/ +``` + +### SSH 鍵 + +user-data ファイルの ssh プロパティで指定します。 + +例: + + +```yml +# user-data + ssh: + # SSH サーバーのインストール + install-server: true + # パスワード認証の無効化 + allow-pw: false + # SSH 公開鍵 + authorized-keys: + - "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIG4AR5BAWlw5a9RzyTkYK9ApoTerpNg0qb3kMActUyvN" +``` + + +SSH 公開鍵は `ssh-keygen` コマンドなどで生成します。 + +例: + +```console +$ ssh-keygen -t ed25519 +$ cat ~/.ssh/id_ed25519.pub +ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIG4AR5BAWlw5a9RzyTkYK9ApoTerpNg0qb3kMActUyvN localhost +``` + +### APT sources.list の設定 + +user-data ファイルの apt プロパティで指定します。 + +### APT パッケージのインストール + +user-data ファイルの packages プロパティで指定します。 + +### 初回起動時に 1 度実行するスクリプト + +いくつか方法はありますが、ここでは rc-local.service を使う方法を紹介します。 +user-data ファイルの late-commands プロパティに下記のようなコマンドを追加します。 + +例: + + +```yml +# user-data + late-commands: + - | + cat < + +## 参考文献 + +[Autoinstall Reference](https://ubuntu.com/server/docs/install/autoinstall-reference) + ## ライセンス イメージに含まれているソフトウェアの[ライセンス情報](https://packages.ubuntu.com/)をご参照ください。