DEV Community: Borikatsu

wsl2 の設定備忘録

Borikatsu — Fri, 06 Oct 2023 12:06:49 +0000

個人用備忘録。OS は Ubuntu 前提です

root 以外のユーザをデフォルト起動ユーザにしたい

基本設定

VSCode とかで wsl に接続した際にデフォルト起動ユーザを変更する方法。
公式の方法

Ubuntu にログインして conf の設定を変更するだけ
※hoge の部分はユーザ名

$ sudo vi /etc/wsl.conf
[user]
default=hoge

Windows Terminal での設定

[設定] → [Ubuntu] → [コマンドライン]
を開いて起動コマンドを変更する。
※hoge の部分はユーザ名

# デフォルト
C:\WINDOWS\system32\wsl.exe -d Ubuntu

# 変更後
C:\WINDOWS\system32\wsl.exe -d Ubuntu --user hoge

GUI の有効化

Windows 10 から利用できるようになった Windows Subsystem for Linux GUI を利用。

最新版の wsl でなければ更新。

# 管理者権限が必要
> wsl --update

# バージョン確認
> wsl --version
WSL バージョン: 1.2.5.0
カーネル バージョン: 5.15.90.1
WSLg バージョン: 1.0.51 # GUI機能が利用可能
MSRDC バージョン: 1.2.3770
Direct3D バージョン: 1.608.2-61064218
DXCore バージョン: 10.0.25131.1002-220531-1700.rs-onecore-base2-hyp
Windows バージョン: 10.0.22621.2428

X11 アプリケーションをインストールして GUI が wsl から利用できるか確認。

$ sudo apt update
$ sudo apt install -y x11-apps

電卓が起動すればWSLgを利用できる状態
$ xcalc

Chromiumのインストール

sudo apt install -y libgtk2.0-0 libgtk-3-0 libnotify-dev libgconf-2-4 libnss3 libxss1 libasound2 libxtst6 xauth xvfb libgbm-dev fonts-ipafont

sshの鍵設定

# keychain インストール
$ sudo apt-get install keychain

$ 起動設定
$ vi ~/.bashrc
/usr/bin/keychain -q --nogui $HOME/.ssh/id_rsa
source $HOME/.keychain/$HOST-sh

クリーンアーキテクチャと DDD を意識したパッケージ構成についての思案

Borikatsu — Sat, 16 Sep 2023 06:57:04 +0000

プロジェクトを新しく始める時、既存のイケてないアプリケーションのリファクタリングを始めたい時、アプリケーションのパッケージ構成について頭を悩まされることが増えた。

でも結局のところ、どういうパッケージ構成でアプリケーションを作ればいいのかわからない。何がベストなのかもわからない。

そんな自分への備忘録

クリーンアーキテクチャと DDD の違い

クリーンアーキテクチャとは
- コンポーネントをレイヤー毎に分割することで各レイヤの関心事を分離する
- 各層の依存関係は内側へと向かう(内側に依存する)
- 抽象的な interface を外側に向けて提供することで、制御の流れと依存関係を逆転させる
DDD(ドメイン駆動設計)とは
- アプリケーションが扱うビジネスにおける「知識」や「ルール」、「要求」をドメインモデルとして表現する
- ビジネスロジックを流出させないことで、ビジネスの成長と共にドメインモデルも習熟していく

クリーンアーキテクチャはアプリケーションの設計をどのように行うべきかを説く設計思想。

一方、ドメイン駆動設計はアプリケーションにおけるドメインモデルを定義し、それをどのように成長させていくかに着目している開発手法。

だと思っている。

そもそもなぜアーキテクチャ設計に考えを巡らせる必要があるのか

具体化するために自問自答。

Q. アーキテクチャ設計の必要性とは？
A. 保守しやすいアプリケーションを作るため

Q. 保守しやすいアプリケーションとは？
A. コードのメンテナンス性が高い

Q. メンテナンス性が高いコードとは？
A. 各コードの責務が分離されており、変更を加えても影響範囲が小さいこと

Q. より具体的には？
A. ユニットテストが書きやすい

なんとなく腑に落ちたので、ユニットテストが書きやすいアーキテクチャを目標にパッケージ構成を考えてみる。

構成案

各層配下のディレクトリはドメイン単位で作成する。



root
├── application
│   └── usecase(ユースケースの実態)
│       └── mapper(プレゼンテーション層とアプリケーション層間のマッパー)
├── domain
│   ├── adapter(各層との緩衝材)
│   │   ├── in(ユースケースの抽象化)
│   │   │   └── input(ユースケースの入力用DTO)
│   │   └── out(インフラ層の操作の抽象化)
│   └── model(ドメインモデルの格納)
│       ├── entity(値オブジェクトなどの集合体)
│       └── value(値オブジェクトや区分オブジェクト)
├── infrastructure
│   ├── datasource(データベース)
│   │   ├── adapter(インフラ層の操作の実態)
│   │   ├── entity(ORM Entity)
│   │   ├── mapper(DTOへの変換)
│   │   └── repository(データベース操作の実態)
│   ├── externalapi(外部API)
│   │   ├── adapter
│   │   ├── config(WebClientのコンフィグ)
│   │   ├── mapper
│   │   ├── request
│   │   └── response
│   └── transfer(外部ストレージ)
└── presentation
    ├── controller
    │   ├── request
    │   └── response
    └── handler(コントローラー共通処理)

参考

各層の役割

おなじみの図を元に考える。

インフラ層

ORM で管理する各データオブジェクトを entity に格納して repository で DB 操作を実装する。(ここでいう entity は DDD における entity ではない)

例えば Spring Data JPA なら以下のような形。



@Entity
public class UserEntity {
  @Id
  @Column
  String id;

  @Column
  String name;
}

public interface UserRepository extends JpaRepository<UserEntity, String> {}

repository から得られるデータはインフラ層のみが知るべき I/F であるため、mapper を介してドメイン層の I/F へ変換を行う adapter を実装することでインフラ層をドメイン層に依存させる。(依存性の逆転)



public class UserAdapterImpl implements UserAdapter {
    @Override
    public UserId save(User user) {
        UserEntity savedUser = userRepository.save(mapper.toEntity(user));
        return UserId.from(savedUser.getId());
    }
}

datasource 以外のパッケージについて

externalapi、transfer でも基本的な考えは同じ。

外部との I/F を繋ぐ adapter をドメイン層に依存する形で定義し、entity となるクラスを用意して mapper で DTO へ変換する。

例えば外部 API なら API の response が entity に当たり、外部ストレージなら Stream、IO などという具合。

アプリケーション層

アプリケーションにおけるドメインオブジェクトのユースケースの定義。(ユーザーの登録、参照、更新、削除)

プレゼンテーション層からの入力を受け付けるための I/F として input クラスをドメイン層に用意する。

ユースケース単位にクラスを作成していき、handle や execute など共通メソッドを実装してプレゼンテーション層から利用する。



public class AddUserImpl implements AddUser {
    public UserId handle (AddUserInput input) {
        User user = User.from(input);
        return userAdapter.save(user);
    }
}

ドメイン層

隣接するアプリケーション層とインフラ層それぞれをドメイン層に依存させるためのインターフェースを定義する。

具体的には、ヘキサゴナルアーキテクチャのポートアンドアダプターのようにアプリケーション層からの input とインフラ層への output を adapter という名称でパッケージを切る。

ドメインオブジェクトについて

value

Enum などの区分オブジェクトや UserId などの値オブジェクトを表現する。
(DDD における ValueObject)

entity

値オブジェクトや区分オブジェクトの集合体としてドメインオブジェクトを構成する。
(DDD における Entity)

レイヤー間の I/F について

プレゼンテーション層からの入力値をそのままドメインオブジェクトに変換することは難しいが、インフラ層の ORM Entity をドメインオブジェクトに変換するのは比較的容易いと感じた。

例えば、ユーザのドメインオブジェクトには名前とメールアドレスのフィールドがあるので DB にも 2 カラム定義している。

しかし、ユースケースとしてはメールアドレスだけ登録すればユーザ登録が可能。名前は後から設定でも OK、というようなパターン。

そのため、ユースケース用の専用 DTO を input として用意したが、インフラ層の DTO は ORM Entity から DDD Entity へ直接変換する構成を取った。

また、構成を合わせるという意味では、ORM Entity の格納場所はインフラ層ではなくドメイン層の adapter/out 配下に定義するのが綺麗かとも考えたが、ORM の概念をドメイン層に持ち出したくなかったのでインフラ層側に entity を配置している。

この点については運用しながら最適な構成を模索するような形で様子見をしたい。

所感

これが正解であることはきっとないが、いったん今の自分が考えられるベストな構成であると思いたい。

この構成を元にサンプル API アプリケーションを作って本当にテストコードが書きやすいのかを検証する。

UbuntuにJavaの開発環境構築

Borikatsu — Thu, 14 Sep 2023 12:09:18 +0000

Ubuntu に Java(jdk)をインストールする。
バージョン管理は apt の pkg マネージャーに任せる。

会社の PC 設定する時に毎回調べたり、個人 PC の設定忘れがちなのでメモとして。

やること

jdk インストール
環境変数の設定
バージョン切替

バージョン切替は付録的な話

jdk のインストール

# 提供バージョンの確認
$ sudo apt search openjdk-.*-jdk$

# 利用するバージョンをインストール
## 11と17をインストール
$ sudo apt install -y openjdk-11-jdk openjdk-17-jdk

# インストール確認
$ java --version
openjdk 17.0.8.1 2023-08-24
OpenJDK Runtime Environment (build 17.0.8.1+1-Ubuntu-0ubuntu120.04)
OpenJDK 64-Bit Server VM (build 17.0.8.1+1-Ubuntu-0ubuntu120.04, mixed mode, sharing)

環境変数の設定

# profileに追記
$ echo '# JDK
JAVA_HOME=$(readlink -f /usr/bin/javac | sed "s:/bin/javac::")
export JAVA_HOME
PATH=$PATH:$JAVA_HOME/bin
export PATH' | tee -a ~/.profile > /dev/null

# 再読み込み
$ source ~/.profile

バージョン切替するとき

# 現在のバージョン
$ java --version
openjdk 17.0.8.1 2023-08-24
OpenJDK Runtime Environment (build 17.0.8.1+1-Ubuntu-0ubuntu120.04)
OpenJDK 64-Bit Server VM (build 17.0.8.1+1-Ubuntu-0ubuntu120.04, mixed mode, sharing)

# 切り替え可能なバージョン
$ sudo update-java-alternatives --list
java-1.11.0-openjdk-amd64      1111       /usr/lib/jvm/java-1.11.0-openjdk-amd64
java-1.17.0-openjdk-amd64      1711       /usr/lib/jvm/java-1.17.0-openjdk-amd64

# 11に切替
$ sudo update-java-alternatives --set java-1.11.0-openjdk-amd64

切替後の確認

$ java --version
openjdk 11.0.20.1 2023-08-24
OpenJDK Runtime Environment (build 11.0.20.1+1-post-Ubuntu-0ubuntu120.04)
OpenJDK 64-Bit Server VM (build 11.0.20.1+1-post-Ubuntu-0ubuntu120.04, mixed mode, sharing)

$  which java
/usr/bin/java

# 関連バイナリ全部切り替わっているか確認
$ ls -l /etc/alternatives/java*
lrwxrwxrwx 1 root root 43 Sep  9 16:58 /etc/alternatives/java -> /usr/lib/jvm/java-11-openjdk-amd64/bin/java
lrwxrwxrwx 1 root root 53 Sep  9 16:58 /etc/alternatives/java.1.gz -> /usr/lib/jvm/java-11-openjdk-amd64/man/man1/java.1.gz
lrwxrwxrwx 1 root root 44 Sep  9 16:58 /etc/alternatives/javac -> /usr/lib/jvm/java-11-openjdk-amd64/bin/javac
lrwxrwxrwx 1 root root 54 Sep  9 16:58 /etc/alternatives/javac.1.gz -> /usr/lib/jvm/java-11-openjdk-amd64/man/man1/javac.1.gz
lrwxrwxrwx 1 root root 46 Sep  9 16:58 /etc/alternatives/javadoc -> /usr/lib/jvm/java-11-openjdk-amd64/bin/javadoc
lrwxrwxrwx 1 root root 56 Sep  9 16:58 /etc/alternatives/javadoc.1.gz -> /usr/lib/jvm/java-11-openjdk-amd64/man/man1/javadoc.1.gz
lrwxrwxrwx 1 root root 44 Sep  9 16:58 /etc/alternatives/javap -> /usr/lib/jvm/java-11-openjdk-amd64/bin/javap
lrwxrwxrwx 1 root root 54 Sep  9 16:58 /etc/alternatives/javap.1.gz -> /usr/lib/jvm/java-11-openjdk-amd64/man/man1/javap.1.gz

大丈夫そう。イイネ！

以上。

Ubuntuにnode入れてバージョン管理

Borikatsu — Sun, 10 Sep 2023 00:20:10 +0000

Ubuntu に nodejs と npm と yarn 入れる。
node と npm は n でバージョン管理する。

会社の PC 設定する時に毎回調べたり、個人 PC の設定忘れがちなのでメモとして。

やること

n をインストールするためのテンポラリな node と npm をインストール
n をインストールする
node/npm を n で再インストール
テンポラリな node と npm を削除
yarn をインストール

れっつごー

n をインストールするまで

# pkgマネージャーからnode/npmをインストール(テンポラリ利用)
$ sudo apt install -y nodejs npm

# n をインストール
$ sudo npm install n -g

node/npm を再インストール

# 安定バージョン
$ sudo n stable

# 最新バージョン
$ sudo n latest

# バージョン指定
## リモートのバージョン確認
$ sudo n ls-remote | head
Listing remote... Displaying 20 matches (use --all to see all).
20.6.1
20.6.0
20.5.1
20.5.0
20.4.0
20.3.1
20.3.0
20.2.0
20.1.0

## 20.1.0を利用
$ sudo n 20.1.0

テンポラリの node と npm を削除

$ sudo apt purge -y nodejs npm
$ sudo apt autoremove -y

yarn インストール

$ npm install -g yarn

結果

基本は安定板を利用。

$ node -v
v18.17.1
$ npm -v
9.6.7
$ yarn -v
1.22.19

以上

Docker Desctop使わずにWSL2でDockerを使う

Borikatsu — Thu, 07 Sep 2023 13:50:46 +0000

Docker Desktop を利用するには支払いが必要ですか

個人利用なら Docker Desktop は無料で利用できるが、ビジネス目的での利用だと少し制限がある。

別に個人で利用している分には Docker Desctop を使い続ければいいのだが、使わずに WSL 上の Ubuntu にインストールして動かすこともできるらしかったので試してみた。
（いつか個人利用でも有償になった時のために）

さっそくインストールしてみよう

Install Docker Engine on Ubuntu
↑ Docker が公式で出している Ubuntu OS に Docker Engine をインストールする方法。
書いてある通りに進めていけば Docker 動くようになるとのこと。めちゃ簡単。

Install using the Apt repository
↑ インストールするための準備コマンドが記載されている項目。

若干ライブラリが足りてなかったりするので、
https://dev.to/felipecrs/simply-run-docker-on-wsl2-3o8
を参考に以下のコマンドを実施。

# Add Docker's official GPG key:
$ sudo apt-get update
$ sudo apt-get install ca-certificates curl gnupg lsb-release
$ sudo mkdir -p /etc/apt/keyrings
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# Add the repository to Apt sources:
$ echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

$ sudo apt-get update

そして、最新版で問題ないので以下のコマンドでインストール。

$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

ちなみにバージョン指定してインストールする方法は以下。

## バージョン情報の確認
$ apt-cache madison docker-ce | awk '{ print $3 }'
5:24.0.0-1~ubuntu.22.04~jammy
5:23.0.6-1~ubuntu.22.04~jammy
...

## インストールしたいバージョンを指定してインストール
$ VERSION_STRING=5:24.0.0-1~ubuntu.22.04~jammy
$ sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin

起動設定

まず Docker のデーモンを立ち上げる上での管理グループ & ユーザーを作成する。
※Docker Desctop をインストールしたことがあるなら既に作成されているはずなのでこの手順は不要。

# Ensures docker group exists
$ sudo groupadd docker

# Ensures you are part of it
$ sudo usermod -aG docker $USER

Ubuntu にログインするとデーモンが立ち上がるように bash に設定を追記

$ vi ~/.profile
if service docker status 2>&1 | grep -q "is not running"; then
    wsl.exe -d "${WSL_DISTRO_NAME}" -u root -e /usr/sbin/service docker start >/dev/null 2>&1
fi

できあがり

$ /usr/sbin/service docker status
 * Docker is running

$ docker --version
Docker version 24.0.6, build ed223bc

$ docker compose version
Docker Compose version v2.21.0

Ubuntu にログインして、Docker デーモンが起動していること、バージョン情報が表示されるので正常インストールされていることが確認できた。

ガントチャートを楽に管理したい

Borikatsu — Tue, 05 Sep 2023 12:42:29 +0000

Excel でのガントチャート管理に疲れた。
宗教的な理由からも Excel は嫌。

Backlog とか Jira とか、タスク管理アプリでも WBS 作れるけど正直そんなに便利ではない。
タスクの期限が変わったりすると、他タスクの期限全部調整するハメになったりするし。

なんかいい案ないのかな

あった
PlantUML におけるガントチャートの書き方
↑ ふむふむ、なるほど、ふーんて感じ

まあ plantUML なら使ったことある人多いだろうし、コードでガント管理できるのもエンジニアっぽくていい感じな気がする！！

でも生成した画像をぱっとブラウザ上で見たりしたいけどできるのかな？
↓
多分できない

他にもないかなと探していたら、こんなのもあるぽい
Mermaid を使ってガントチャートを書こう。

・・・こっちのが主流ぽい？

GitHub で Mermaid 構文の表示機能が強化されていました
Github でもサポートしてる。

・・・Mermaid 試してみるか

お試し

まずはセットアップ。以下の記事を参考にする。
VSCode で Mermaid を扱う為の便利な拡張機能あれこれ

とりあえず以下を VScode の拡張機能としてインストールした（他は PDF にエクスポートとかする機能だったので、必要になったらでいいかなと）

さっそく VScode で qita の記事に書いてあるサンプルを開いてみた。

良い感じやん！！
そしてこれを Github にうｐすると、画像の状態でプレビューできるのかな？

とりあえず適当に.md ファイル作ってさっきのコードペタっとして・・・

あら素敵

実際に使ってみた感想

Github 上だと、画像右上の ⇔ ボタンで拡大プレビューもできて使い勝手もよろしい。
ただ、凝った見た目にはならないので、内々で使うものにとどめておくのがよいかな。

後は、タスク名を変数にして、各タスクの開始日を a タスクの後、みたいにできるので差し込みタスクが来た時などにスケジュールのパズルがしやすい・・かも

DEV Community: Borikatsu

wsl2 の設定備忘録

目次

root 以外のユーザをデフォルト起動ユーザにしたい

基本設定

Windows Terminal での設定

GUI の有効化

Chromiumのインストール

sshの鍵設定

クリーンアーキテクチャと DDD を意識したパッケージ構成についての思案

目次

クリーンアーキテクチャと DDD の違い

そもそもなぜアーキテクチャ設計に考えを巡らせる必要があるのか

構成案

参考

各層の役割

インフラ層

datasource 以外のパッケージについて

アプリケーション層

ドメイン層

ドメインオブジェクトについて

value

entity

レイヤー間の I/F について

所感

UbuntuにJavaの開発環境構築

目次

やること

jdk のインストール

環境変数の設定

バージョン切替するとき

切替後の確認

Ubuntuにnode入れてバージョン管理

目次

やること

n をインストールするまで

node/npm を再インストール

テンポラリの node と npm を削除

yarn インストール

結果

Docker Desctop使わずにWSL2でDockerを使う

目次

さっそくインストールしてみよう

起動設定

できあがり

ガントチャートを楽に管理したい

目次

なんかいい案ないのかな

お試し

実際に使ってみた感想