差分

このページの2つのバージョン間の差分を表示します。

--- windows:wsl:install [2019/09/14 00:22] – [ディストリビューションパッケージの更新] ともやん
+++ windows:wsl:install [2023/03/15 05:53] (現在) – [☢️古い資料です☢️] ともやん
@@ 行 1: / 行 1: @@
-<html>
+~~CLOSETOC~~
-  <style>
+====== Windows Subsystem for Linux (WSL) Version 2 のインストール ======
-    #result pre {
+{{INLINETOC wide 1-2}}
-      height: 200px;
+\\
-      overflow: scroll;
-      overflow-x: hidden;
+===== Windows 10 ビルド番号を確認 =====
-    }
+PowerShell より Windows 10 ビルド [[https://blogs.windows.com/windowsexperience/2019/06/12/announcing-windows-10-insider-preview-build-18917/|18917]] - 2019/06/12 以降を実行していることを確認する。\\
-  </style>
+<WRAP center round important 100%>
-</html>
+※Windows 10 Insider Preview では Build 18917 から WSL 2 を提供。\\
-====== WSL 2 のインストール ======
+　Windows 10 一般提供では バージョン 2004 (Build 19041) から WSL 2 を提供。\\
+　参考: [[windows:version_build_info|Windows Version Build 情報]]\\
+</WRAP>
+<WRAP prewrap 100%>
+<code powershell>
+$ Get-CimInstance Win32_OperatingSystem | Format-List
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+**Insider Preview の例**\\
+<code powershell>
+SystemDirectory : C:\WINDOWS\system32
+Organization    :
+BuildNumber     : 20206
+RegisteredUser  : tomoyan
+SerialNumber    : 00330-80000-00000-AA721
+Version         : 10.0.20206
+</code>
+**一般提供の例**\\
+<code powershell>
+SystemDirectory : C:\WINDOWS\system32
+Organization    :
+BuildNumber     : 19042
+RegisteredUser  : tomoyan
+SerialNumber    : 00330-80000-00000-AA162
+Version         : 10.0.19042
+</code>
+</WRAP>
+WSL を提供していない Windows 10 を実行している場合は、[スタート] - [設定] - [更新とセキュリティ] - [Windows Update] の順に選択し、[更新プログラムのチェック] を実行する。\\
+**PowerShell** で **wsl** コマンドを実行する。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ wsl
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
+Copyright (c) Microsoft Corporation. All rights reserved.
+使用方法: wsl.exe [Argument]
+引数:
+    --install
+        Linux 用 Windows サブシステムのオプション機能を有効にします。
+        このコマンドは、管理者特権でのコマンド プロンプトから実行する必要があります。
+    --help
+        使用方法の情報を表示します。
+</code>
+</WRAP>
+===== インストール =====
+**wsl --install** コマンドを管理者で実行していない場合は、以下のような実行結果になる。\\
+<WRAP prewrap 100%>
+<code>
+$ wsl --install
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
+要求された操作には管理者特権が必要です。
+</code>
+</WRAP>
+管理者実行している **PowerShell** で **wsl --install** コマンドを実行する。\\
+もしくは、[[windows:sudo|]] で管理者実行する。\\
+<WRAP prewrap 100%>
+<code>
+$ sudo wsl --install
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
+Installing Windows Subsystem for Linux
+[==========================74.8%============               ]
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
+Windows Subsystem for Linux is now installed.
+Downloading and installing WSL kernel
+[============              21.4%                           ]
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
+Installing Windows Subsystem for Linux
+Windows Subsystem for Linux is now installed.
+Downloading and installing WSL kernel
+WSL kernel is now installed.
+要求された操作は正常に終了しました。変更を有効にするには、システムを再起動する必要があります。</code>
+</WRAP>
+変更を有効にするために Windows を再起動する。\\
+===== 再起動後に wsl コマンドを実行 =====
+WSL のインストールが完了すると **wsl** コマンドの説明が以下のように変わる。\\
+<WRAP prewrap 100%>
+<code>
+$ wsl --help
+</code>
+</WRAP>
+<WRAP prewrap 100% #result_long>
+**Insider Preview の例**\\
+<code powershell>
+Copyright (c) Microsoft Corporation. All rights reserved.
+使用法: wsl.exe [Argument] [Options...] [CommandLine]
+Linux バイナリを実行するための引数:
+    コマンド ラインを指定しないと、wsl.exe は既定のシェルを起動します。
+    --exec, -e <CommandLine>
+        指定したコマンドを、既定の Linux シェルを使用しないで実行します。
+    --
+        残りのコマンド ラインをそのまま渡します。
+オプション:
+    --distribution, -d <ディストリビューション>
+        指定したディストリビューションを実行します。
+    --user, -u <UserName>
+        指定したユーザーとして実行します。
+Linux 用 Windows サブシステムを管理するための引数:
+    --export <ディストリビューション> <FileName>
+        ディストリビューションを tar ファイルにエクスポートします。
+        標準出力の場合は、ファイル名を - とすることができます。
+    --import <ディストリビューション> <InstallLocation> <FileName> [Options]
+        指定した tar ファイルを新しいディストリビューションとしてインポートします。
+        標準入力の場合は、ファイル名を - とすることができます。
+        オプション:
+            --version <バージョン>
+                新しいディストリビューションに使用するバージョンを指定します。
+    --list, -l [Options]
+        ディストリビューションの一覧を表示します。
+        オプション:
+            --all
+                現在インストール中またはアンインストール中のものを含めて
+                すべてのディストリビューションを一覧表示します。
+            --running
+                現在実行中のディストリビューションのみを一覧表示します。
+            --quiet, -q
+                ディストリビューション名のみを表示します。
+            --verbose, -v
+                すべてのディストリビューションについての詳細情報を表示します。
+    --set-default, -s <ディストリビューション>
+        ディストリビューションを既定として設定します。
+    --set-default-version <バージョン>
+        新しいディストリビューションの既定のインストール バージョンを変更します。
+    --set-version <ディストリビューション> <バージョン>
+        指定したディストリビューションのバージョンを変更します。
+    --shutdown
+        実行中のすべてのディストリビューションと WSL 2 ライトウェイト ユーティリティ仮想マシンを直ちに終了します。
+    --terminate, -t <ディストリビューション>
+        指定したディストリビューションを終了します。
+    --unregister <ディストリビューション>
+        ディストリビューションの登録を解除し、ルート ファイル システムを削除します。
+    --help
+        使用法を表示します。
+    --update [Options]
+        WSL 2 カーネルに対する更新を管理します。オプションが指定されていない場合は、
+        最新バージョンのカーネルに更新します。
+        オプション:
+            --rollback
+                以前のバージョンの WSL 2 カーネルに戻します。
+            --status
+                更新の状態を表示します。
+</code>
+**一般提供の例**\\
+<code powershell>
+Copyright (c) Microsoft Corporation. All rights reserved.
+使用法: wsl.exe [引数] [オプション...] [コマンド ライン]
+Linux バイナリを実行するための引数:
+    コマンド ラインを指定しないと、wsl.exe は既定のシェルを起動します。
+    --exec, -e <コマンド ライン>
+        指定したコマンドを、既定の Linux シェルを使用しないで実行します。
+    --
+        残りのコマンド ラインをそのまま渡します。
+オプション:
+    --distribution, -d <ディストリビューション>
+        指定したディストリビューションを実行します。
+    --user, -u <ユーザー名>
+        指定したユーザーとして実行します。
+Linux 用 Windows サブシステムを管理するための引数:
+    --export <ディストリビューション> <ファイル名>
+        ディストリビューションを tar ファイルにエクスポートします。
+        標準出力の場合は、ファイル名を - とすることができます。
+    --import <ディストリビューション> <インストール場所> <ファイル名> [オプション]
+        指定した tar ファイルを新しいディストリビューションとしてインポートします。
+        標準入力の場合は、ファイル名を - とすることができます。
+        オプション:
+            --version <バージョン>
+                新しいディストリビューションに使用するバージョンを指定します。
+    --list, -l [オプション]
+        ディストリビューションの一覧を表示します。
+        オプション:
+            --all
+                現在インストール中またはアンインストール中のものを含めて
+                すべてのディストリビューションを一覧表示します。
+            --running
+                現在実行中のディストリビューションのみを一覧表示します。
+            --quiet, -q
+                ディストリビューション名のみを表示します。
+            --verbose, -v
+                すべてのディストリビューションについての詳細情報を表示します。
+    --set-default, -s <ディストリビューション>
+        ディストリビューションを既定として設定します。
+    --set-default-version <バージョン>
+        新しいディストリビューションの既定のインストール バージョンを変更します。
+    --set-version <ディストリビューション> <バージョン>
+        指定したディストリビューションのバージョンを変更します。
+    --shutdown
+        実行中のすべてのディストリビューションと WSL 2 ライトウェイト ユーティリティ仮想マシンを直ちに終了します。
+    --terminate, -t <ディストリビューション>
+        指定したディストリビューションを終了します。
+    --unregister <ディストリビューション>
+        ディストリビューションの登録を解除します。
+    --help
+        使用法を表示します。
+</code>
+Insider Preview と表示内容が若干異なるが支障はない。\\
+</WRAP>
+====== ☢️古い資料です (Obsolete)☢️ ======
+===== Windows Subsystem for Linux (WSL) Version 2 のインストール =====
+**__注意: [[.:lxrunoffline|LxRunOffline - システムドライブ外に WSL 環境を構築する方法]] で公式の Fedora を WSL で利用できる。__**\\
+本手順では、WSL 2 上に [[https://github.com/WhitewaterFoundry/Fedora-Remix-for-WSL|Fedora Rimix for WSL]] ディストリビューションをインストールする。\\
+Fedora ファンとしては、Fedora Remix for WSL が Fedora 公式ではないのがちょっと残念ではあるが、使い慣れた Fedora が Windows 10 でも使えるのはありがたい。\\
+\\
+現在 [[https://github.com/WhitewaterFoundry/Fedora-Remix-for-WSL|Fedora Remix for WSL]] は [[https://www.pengwin.dev/|Whitewater Foundry]] が [[https://getfedora.org/ja/|Fedora Project]] 非公式でメンテしている。\\
+実は、[[https://github.com/WhitewaterFoundry/WSLFedoraRemix/releases|GitHub]] を介して無料でサイドロードできる Fedora Remix for WSL の署名済みダウンロードも提供している。\\
+無償で利用したい場合は試してみるとよいだろう。\\
+\\
 ※ 2019/09/13 現在 Build 18917 以降は **[[windows:windows_10_insider_previews|Windows 10 Insider Previews]]** としてのみ公開されている。\\
 以下の手順は Build 18362 ～ 18980 へ更新しながら検証した。\\
 ===== Windows 10 ビルド番号を確認 =====
-コマンドプロンプトより Windows 10 ビルド 18917 以降を実行していることを確認する。\\
+PowerShell より Windows 10 ビルド [[https://blogs.windows.com/windowsexperience/2019/06/12/announcing-windows-10-insider-preview-build-18917/|18917]] - 2019/06/12 以降を実行していることを確認する。\\
-<code batch>
+<WRAP center round important 100%>
-> ver
+※Windows 10 Insider Preview では Build 18917 から WSL 2 を提供。\\
+　Windows 10 一般提供では バージョン 2004 (Build 19041) から WSL 2 を提供。\\
+</WRAP>
+<code powershell>
+$ Get-CimInstance Win32_OperatingSystem | Format-List
-Microsoft Windows [Version 10.0.18362.356]
+SystemDirectory : C:\WINDOWS\system32
+Organization    :
+BuildNumber     : 18362
+RegisteredUser  : tomoyan
+SerialNumber    : 00330-80000-00000-AA721
+Version         : 10.0.18362
 </code>
 [スタート] - [設定] - [更新とセキュリティ] - [Windows Update] の順に選択し、[更新プログラムのチェック] を実行する。\\
-<code batch>
+<code powershell>
-> ver
+$ Get-CimInstance Win32_OperatingSystem | Format-List
-Microsoft Windows [Version 10.0.18980.1]
+SystemDirectory : C:\WINDOWS\system32
+Organization    :
+BuildNumber     : 18980
+RegisteredUser  : tomoyan
+SerialNumber    : 00330-80000-00000-AA721
+Version         : 10.0.18980
 </code>
 ===== Hyper-V の有効化 =====
 PowerShell を管理者実行する。\\
+<WRAP prewrap 100%>
 <code batch>
 > powershell start-process powershell -verb runas
 </code>
+</WRAP>
 管理者実行した PowerShell で Hyper-V が有効になっていることを確認する。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ bcdedit /enum | find `"hypervisorlaunchtype`"
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > bcdedit /enum | find `"hypervisorlaunchtype`"
 hypervisorlaunchtype    Auto
 </code>
+</WRAP>
 Hyper-V が Off の場合は On にする。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ bcdedit /enum | find `"hypervisorlaunchtype`"
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > bcdedit /enum | find `"hypervisorlaunchtype`"
 hypervisorlaunchtype    Off
 </code>
+</WRAP>
+<WRAP prewrap 100%>
+<code powershell>
+$ bcdedit /set hypervisorlaunchtype auto
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > bcdedit /set hypervisorlaunchtype auto
 この操作を正しく終了しました。
 </code>
+</WRAP>
 Hyper-V を有効化した場合は PC を一旦再起動する。\\
+<WRAP prewrap 100%>
 <code powershell>
-PS > shutdown /r /t 0
+$ shutdown /r /t 0
 </code>
+</WRAP>
 ===== 仮想マシン プラットフォームの有効化 =====
 再起動した場合は再び PowerShell を管理者として実行する。\\
 **"仮想マシン プラットフォーム"** のオプション コンポーネントを有効にする。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > Enable-WindowsOptionalFeature -Online -FeatureName VirtualMachinePlatform
 Path          :
 Online        : True
 RestartNeeded : False
 </code>
+</WRAP>
 **"仮想マシン プラットフォーム"** を有効化したら再び PC を再起動する。\\
+<WRAP prewrap 100%>
 <code powershell>
-PS > shutdown /r /t 0
+$ shutdown /r /t 0
 </code>
+</WRAP>
 ===== Windows Subsystem for Linux (WSL) のインストール =====
 再起動した場合は再び PowerShell を管理者として実行する。\\
 Windows Subsystem for Linux をインストールする。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
 この操作を完了するために、今すぐコンピューターを再起動しますか?
 [Y] Yes  [N] No  [?] ヘルプ (既定値は "Y"): <- Enter キーを入力
 </code>
+</WRAP>
 ===== Linux ディストリビューションのインストール =====
@@ 行 87: / 行 424: @@
 ダウンロードが完了したら [スタート] - [Fedora Rimix for WSL] を起動してみる。\\
+<WRAP prewrap 100% #result>
 <code>
 Unpacking Linux filesystem image, this may take a few minutes...
@@ 行 94: / 行 432: @@
 Press any key to continue...
 </code>
+</WRAP>
 化けているが... 本当はこういうエラーらしい。\\
+<WRAP prewrap 100% #result>
 <code>
 Unpacking Linux filesystem image, this may take a few minutes...
@@ 行 101: / 行 441: @@
 Press any key to continue...
 </code>
+</WRAP>
 Windows Subsystem for Linux を一旦無効化する。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > Disable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
 この操作を完了するために、今すぐコンピューターを再起動しますか?
 [Y] Yes  [N] No  [?] ヘルプ (既定値は "Y"): <- Enter キーを入力
 </code>
+</WRAP>
 再起動したら再び PowerShell を管理者として実行する。\\
 Windows Subsystem for Linux を再度有効化して再起動する。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux
 この操作を完了するために、今すぐコンピューターを再起動しますか?
 [Y] Yes  [N] No  [?] ヘルプ (既定値は "Y"): <- Enter キーを入力
 </code>
+</WRAP>
 再起動が完了したら [スタート] - [Fedora Rimix for WSL] を起動する。\\
 すると今度はきちんと以下のような状態になる。\\
+<WRAP prewrap 100% #result>
 <code>
 Unpacking Linux filesystem image, this may take a few minutes...
@@ 行 125: / 行 479: @@
 Enter new UNIX username:
 </code>
+</WRAP>
 最初にデフォルト Linux ユーザーの作成を行う。\\
+<WRAP prewrap 100% #result>
 <code>
 Welcome to Fedora Remix for WSL. Powered by Pengwin Enterprise.
@@ 行 138: / 行 494: @@
 [tomoyan@Cmon ~]$ exit
 </code>
+</WRAP>
 ===== Windows Subsystem for Linux 2 (WSL 2) を使用するようにディストリビューションを設定 =====
 再び PowerShell を管理者として実行する。\\
 **wsl -l -v** を実行して **Fedora Remix** が初期化済みであることを確認する。\\
+<WRAP prewrap 100%>
+<code powershell>
+$ wsl -l -v
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
 <code powershell>
-PS > wsl -l -v
   NAME           STATE           VERSION
 * fedoraremix    Stopped         1
 </code>
+</WRAP>
 **念のため再度確認！！(重要)**\\
 **wsl** コマンドに **--verbose, -v**、**--set-version** オプションが無い場合は Windows 10 ビルド 18917 以降を実行していないので Windows を更新する。\\
+<WRAP center round important 100%>
+※Windows 10 Insider Preview では Build 18917 から WSL 2 を提供。\\
+　Windows 10 一般提供では バージョン 2004 (Build 19041) から WSL 2 を提供。\\
+</WRAP>
 **--verbose, -v**、**--set-version** オプションが無い例。\\
-<WRAP prewrap 100% #result>
+<WRAP prewrap 100%>
+<code powershell>
+$ wsl --help
+</code>
+</WRAP>
+<WRAP prewrap 100% #result_long>
 <code powershell>
-PS > wsl --help
 Copyright (c) Microsoft Corporation. All rights reserved.
@@ 行 214: / 行 585: @@
 **--verbose, -v**、**--set-version** オプションが有る例。\\
-<WRAP prewrap 100% #result>
+<WRAP prewrap 100%>
 <code powershell>
-PS > wsl --help
+$ wsl --help
+</code>
+</WRAP>
+<WRAP prewrap 100% #result_long>
+<code powershel>
 Copyright (c) Microsoft Corporation. All rights reserved.
@@ 行 294: / 行 669: @@
 **wsl --set-version <Distro> 2** を実行する。\\
 ※ここでは <Distro> は **fedoraremix** である。\\
-<code>
+<WRAP prewrap 100%>
-PS > wsl --set-version fedoraremix 2
+<code powershell>
+$ wsl --set-version fedoraremix 2
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
 変換中です。この処理には数分かかることがあります...
 WSL 2 との主な違いについては、https://aka.ms/wsl2 を参照してください
 変換が完了しました。
 </code>
+</WRAP>
 ===== 今後インストールする新しいディストリビューションが WSL 2 を既定のアーキテクチャとするように設定 =====
-<code>
+<WRAP prewrap 100%>
-PS > wsl --set-default-version 2
+<code powershell>
+$ wsl --set-default-version 2
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
 WSL 2 との主な違いについては、https://aka.ms/wsl2 を参照してください
 </code>
+</WRAP>
 ===== 現在のディストリビューションが使用している WSL のバージョンを確認 =====
 **wsl -l -v** を実行して、現在のディストリビューションが使用している WSL のバージョンを確認する。\\
-<code>
+<WRAP prewrap 100%>
-PS > wsl -l -v
+<code powershell>
+$ wsl -l -v
+</code>
+</WRAP>
+<WRAP prewrap 100% #result>
+<code powershell>
   NAME           STATE           VERSION
 * fedoraremix    Stopped         2
 </code>
+</WRAP>
 以上で WSL 2 を使用する準備が整いました。\\
@@ 行 320: / 行 713: @@
 この状態でいつでも WSL 2 の環境にアクセスできる。\\
 bash の起動は 1 秒も掛からなかった。非常に高速である。\\
+<WRAP prewrap 100% #result_long>
 <code>
 PS > bash
@@ 行 357: / 行 751: @@
 drwxr-xr-x 18 root root   4096 Jun 16 23:09 var
 </code>
+</WRAP>
 ===== ディストリビューション パッケージの更新 =====
 Fedora Rimix for WSL は Fedora 30 相当のようである。\\
 **sudo dnf update** を実行してパッケージを更新する。\\
-<WRAP prewrap 100% #result>
+<WRAP prewrap 100% #result_long>
 <code>
 $ sudo dnf update
@@ 行 523: / 行 918: @@
 </code>
 </WRAP>