Zenn
🐧

WSL開発環境: dotfilesを使った環境管理

2023/12/23に公開
Bash
WSL
環境構築
dotfiles
tech

tl;dr

dotfilesを使用すると、以下の手順で簡単に開発環境を構築できます:

  1. dotfilesリポジトリのフォーク
  2. WSL 環境にdotfilesをクローン
  3. シンボリックリンクを作成して、設定ファイルを管理
  4. profileスクリプトを編集して、自動読み込み

これにより、環境設定の効率的な管理とバージョン管理が可能になります。

Enjoy!

はじめに

WSL上でdotfilesを使用して設定ファイルを一元管理する方法を紹介します。
これにより、バックアップや環境の移行、設定の同期が容易に行えます。

技術用語

この記事で使う技術用語をリストアップします:

  • WSL (Windows Subsystem for Linux):
    Windows上で Linux を実行する機能

  • dotfiles:
    UNIX/Linux系OS の設定ファイルを管理するためのリポジトリ

  • XDG Base Directory:
    設定ファイルやキャッシュなどを整理し、管理を容易にするためのディレクトリ標準規格

  • リポジトリ (Repository):
    バージョン管理システムにおいて、ファイルやディレクトリの変更履歴を保存する場所

  • シンボリックリンク (Symbolic Link):
    あるファイルやディレクトリを別の場所から参照するためのショートカット

1. dotfilesとは

dotfilesは設定ファイルを効率的に管理するためのリポジトリです。
設定のバックアップ、移行、共有が簡単に行えます。

2. dotfilesの初期設定

2.1 dotfilesリポジトリのフォーク

dotfilesリポジトリを自分の GitHub アカウントにフォークし、dotfilesリポジトリをコピーします。
これにより、自分のdotfilesを使って WSL 環境をパーソナライズし、自分だけの開発環境を構築できます。

dotfiles リポジトリにアクセスし、[Fork]ボタンをクリックしてください。

フォークの方法

注意:
フォークすると、自分の GitHub アカウントにdotfilesリポジトリが作成されます。

2.2 dotfilesリポジトリのクローン

フォークしたdotfilesリポジトリを WSL上の Debian にクローンし、dotfilesを WSL上にダウンロードします。

以下のコマンドを実行します:

git clone https://github.com/<myaccount>/dotfiles

注意:
<myaccount>を自分の GitHub アカウントに変えて実行してください。

実行結果は以下のようになります:

Cloning into 'dotfiles'...
remote: Enumerating objects: 1580, done.
remote: Counting objects: 100% (57/57), done.
remote: Compressing objects: 100% (43/43), done.
remote: Total 1580 (delta 19), reused 39 (delta 13), pack-reused 1523
Receiving objects: 100% (1580/1580), 295.93 KiB | 14.09 MiB/s, done.
Resolving deltas: 100% (730/730), done.

この結果、GitHub上のdotfilesがローカルの PC にコピーされます。

2.3 シンボリックリンクの作成

シンボリックリンクを作成することで、設定ファイルを効率的に管理し、常に最新の状態に保つことができます。
これにより、変更をリポジトリに簡単に反映させることができます。

以下のスクリプトを実行して、シンボリックリンクを作成します:

~/.local/dotfiles/scripts/bootstrap-linux/dotfileslinks.sh

実行すると、以下のリンクが作成されます。

$HOME
.config -> ./.local/dotfiles/linux/.config
.editorconfig -> ./.config/.editorconfig
/opt
bin -> /home/<myaccount>/.local/dotfiles/linux/opt/bin
etc -> /home/<myaccount>/.local/dotfiles/linux/opt/etc

注意:
<myaccount>は、自分のアカウントとなります。

2.4 /etc/profile, ~/.profileの書き換え

このステップでは、シェルが起動するたびに自動的にdotfilesの設定が読み込まれるようにしまます。
これにより、環境設定の一貫性と再現性が保たれます。

以下のスクリプトを実行します:

~/.local/dotfiles/scripts/bootstrap-linux/addscripts.sh

実行すると、次の内容がファイルに追加されます。

/etc/profile
if [[ -f /opt/etc/profile]]; then
  . /opt/etc/profile
fi
~/.profile
## exec dotfiles
if [[ -f "$HOME/.config/profile" ]]; then
  . $HOME/.config/profile
fi

おわりに

この記事では、dotfilesリポジトリを使用して WSL の環境を管理する方法について説明しました。
dotfilesを活用することで、WSL の開発環境を迅速かつ効率的に構築できるだけでなく、環境を継続的に管理することも可能になります。

開発環境を素早く構築し、新たなプログラミング体験を楽しみましょう。
それでは、Happy Hacking!

参考資料

Webサイト

GitHubで編集を提案

Discussion