zuntan02のはてなブログ

備忘録的なものです。時々職場の技術者ブログにも転記してますが、メインはこちらで。

【俺的2021標準環境作成メモ】WSL2 + VSCode + Docker 開発環境

【概要】

業務用PC(Windows10Home)に標準的(と思われる)開発環境の構築を行いましたのでメモを残します。

■WSL2インストール

MS公式の手順に従います。
https://docs.microsoft.com/ja-jp/windows/wsl/install-win10
(今回は通常のWindows10の2020年末最新状態を想定し、PowerShellでの作業を実施します)
1)LinuxWindows サブシステムを有効にする
管理者権限でPowerShellを開き、以下のコマンドを実行します

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

2)現在のWindows10のビルドバージョンを確認

  • [Windows]キー+Rでファイル名を指定して実行、を開き、winverコマンドを実行

※必要条件

 x64 システムの場合:バージョン 1903 以降、ビルド 18362 以上。
 ARM64 システムの場合:バージョン 2004 以降、ビルド 19041 以上。
 18362 より前のビルドは WSL 2 をサポートしていません。 Windows 更新アシスタントを使用して、お使いのバージョンの Windows を更新します。

3)”仮想マシン プラットフォーム”オプション機能を有効にする
管理者権限でPowerShellを開き、以下のコマンドを実行します

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

お使いのマシンを 再起動 して WSL のインストールを完了し、WSL 2 に更新します。

4)Linux カーネル更新プログラム パッケージをダウンロードして実行
https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi

5)WSL2を既定のバージョンとして設定
PowerShell

wsl --set-default-version 2

Ubuntuのインストール

1)[MicrosoftStore]でUbuntuで検索、[Ubuntu](実際は20.04LTSの導入となる)を[入手]
2)インストールが完了したら[起動]します
3)UNIX用のユーザー名とパスワードを設定します
4)念のためUpdateします(sudo apt update && sudo apt upgrade)
※この時updateが失敗する場合、/etc/resolv.confの値を以下を参照にして変更しておきます。
【WSL2+Ubuintu】ターミナル開けるたびにresolv.conf書き変わっちゃうの止めたい - zuntan02のはてなブログ

Visual Studio Code のインストールと日本語化

1)VS Code自体は以下のサイトより[Windows]をダウンロードして導入
 https://code.visualstudio.com/download
(2021年07月現在以下のパッケージ導入は自動で行われるようだが念のため残す)
2)VS Codeを起動してウィンドウ上のメニューから[View]-[CommandPalette]-[Configure Display Lanuage]と進みます
3)[Install additional languages...]を選択し、左ペインに表示されるパッケージより[Japanese Language Pack for VS Code]を[install]し、[restart now]します

VS CodeからWSLへの接続

1)VS Codeを起動して、[拡張機能]から、wsl で検索して[Remote - WSL]をインストールします。
2)VS Code 左下の7「><」ボタンより「Nwe WSL Window Remote-WSL」を選択します

■Docker Desktop for Windowsのインストール

1)Docker Desktop(2020年末バージョン3.0.0)のダウンロードサイトよりダウンロードしてインストール
https://www.docker.com/products/docker-desktop
2)Configuration画面で[Install required Windows components for WSL 2]にチェックが入っていることを確認してインストールを完了させてください。

■WSL2 上での確認

1)VS Codeを起動して、[拡張機能]から、Docker で検索して[Docker]を[WSL:Ubuntuにインストールする]でインストールします。
2)Ubuntu のシェルで、docker version とコマンドを実行すると、Docker の情報が表示されます。

■極私的:VS Code拡張いれとくメモ

※プロジェクトによりVS Code拡張機能に規定がある場合があります。プロジェクトに従ってください。

  • Bracket Pair Colorizer
  • vscode-icons
  • Git Graph
  • Git History
  • GitLens — Git supercharged
  • HashiCorp Terraform