mirror of
https://github.com/kou029w/uzura.git
synced 2025-01-18 08:05:01 +00:00
121 lines
3.4 KiB
Markdown
121 lines
3.4 KiB
Markdown
# Uzura
|
|
|
|
Autoinstall USB Flash Drive イメージをビルドするためのツール群
|
|
|
|
- Ubuntu Server (amd64) ベース
|
|
- UEFI のみ対応
|
|
|
|
## 使い方
|
|
|
|
1. [Releases](https://github.com/kou029w/uzura/releases) からイメージをダウンロード
|
|
2. イメージを USB Flash Drive に書き込む
|
|
3. (必要に応じて) USB Flash Drive の中の user-data ファイルを編集して保存
|
|
4. UEFI ブートオプションを変更し、起動
|
|
|
|
## ⚠ 注意
|
|
|
|
- **起動すると自動的にストレージをフォーマットします。必要に応じてあらかじめバックアップを取ってください。**
|
|
- **動作を保証するものではありません。**
|
|
|
|
## 構成
|
|
|
|
user-data ファイルを編集して行います。
|
|
|
|
### ホスト名・ユーザー名・パスワードの設定
|
|
|
|
user-data ファイルの identity プロパティで指定します。
|
|
|
|
例:
|
|
|
|
<!-- prettier-ignore-start -->
|
|
```yml
|
|
# user-data
|
|
identity:
|
|
# ホスト名
|
|
hostname: hostname
|
|
# ユーザー名
|
|
username: ubuntu
|
|
# パスワードのハッシュ値
|
|
password: "$6$iGfCDHv5HM.ATvx2$2jO1Uf1do6mggo5nvbhB4/kEVwV.gAu8yKjGYHjcIHF.NAMFnXjFUtBW0RVPaxIDDe5yfQ4OXlzuwMBcReMAm/"
|
|
```
|
|
<!-- prettier-ignore-end -->
|
|
|
|
パスワードのハッシュ値は `openssl passwd` コマンドなどで生成します。
|
|
|
|
例:
|
|
|
|
```console
|
|
$ openssl passwd -6
|
|
Password:
|
|
Verifying - Password:
|
|
$6$iGfCDHv5HM.ATvx2$2jO1Uf1do6mggo5nvbhB4/kEVwV.gAu8yKjGYHjcIHF.NAMFnXjFUtBW0RVPaxIDDe5yfQ4OXlzuwMBcReMAm/
|
|
```
|
|
|
|
### SSH 鍵
|
|
|
|
user-data ファイルの ssh プロパティで指定します。
|
|
|
|
例:
|
|
|
|
<!-- prettier-ignore-start -->
|
|
```yml
|
|
# user-data
|
|
ssh:
|
|
# SSH サーバーのインストール
|
|
install-server: true
|
|
# パスワード認証の無効化
|
|
allow-pw: false
|
|
# SSH 公開鍵
|
|
authorized-keys:
|
|
- "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIG4AR5BAWlw5a9RzyTkYK9ApoTerpNg0qb3kMActUyvN"
|
|
```
|
|
<!-- prettier-ignore-end -->
|
|
|
|
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 プロパティに下記のようなコマンドを追加します。
|
|
|
|
例:
|
|
|
|
<!-- prettier-ignore-start -->
|
|
```yml
|
|
# user-data
|
|
late-commands:
|
|
- |
|
|
cat <<'EOF' | install /dev/stdin /target/etc/rc.local
|
|
#!/bin/sh
|
|
set -e
|
|
: … ここに初回起動時に実行するコマンドを記述
|
|
# 次回起動時に実行されないようにするためにコマンドの実行に成功したら自身を削除
|
|
rm /etc/rc.local
|
|
EOF
|
|
```
|
|
<!-- prettier-ignore-end -->
|
|
|
|
## 参考文献
|
|
|
|
[Autoinstall Reference](https://ubuntu.com/server/docs/install/autoinstall-reference)
|
|
|
|
## ライセンス
|
|
|
|
イメージに含まれているソフトウェアの[ライセンス情報](https://packages.ubuntu.com/)をご参照ください。
|
|
本リポジトリ内のソフトウェアは CC0-1.0 ライセンスです。
|