JupyterHub - 版の履歴

Kusanaginoturugi: /* ルートユーザーとしての実行 */ リンクを修正

2023-08-20T09:35:41Z

ルートユーザーとしての実行: リンクを修正

← 古い版		2023年8月20日 (日) 18:35時点における版
157行目:		157行目:
	=== ルートユーザーとしての実行 ===		=== ルートユーザーとしての実行 ===

	デフォルトでは、メインの hub プロセスはルートユーザーとして実行されます（個々のユーザーサーバーは、spawner によって設定された対応するローカルユーザーとして実行されます）。非ルートユーザーとして実行するには、[[#SudoSpawner\|SudoSpawner]] を使用する必要があります（上記の他の spawners はルートとしての実行が必要です）。PAM 認証を使用している場合は、非ルートユーザー用に[[#~~PAM~~ ~~authentication~~ as ~~non-root~~ ~~user~~\|それを設定する]]必要もあります。		デフォルトでは、メインの hub プロセスはルートユーザーとして実行されます（個々のユーザーサーバーは、spawner によって設定された対応するローカルユーザーとして実行されます）。非ルートユーザーとして実行するには、[[#SudoSpawner\|SudoSpawner]] を使用する必要があります（上記の他の spawners はルートとしての実行が必要です）。PAM 認証を使用している場合は、非ルートユーザー用に[[#非 root ユーザーとしての PAM 認証\|それを設定する]]必要もあります。

	=== リバースプロキシの使用 ===		=== リバースプロキシの使用 ===

Kusanaginoturugi: /* Tips and Tricks */ 翻訳

2023-08-20T09:34:38Z

Tips and Tricks: 翻訳

← 古い版		2023年8月20日 (日) 18:34時点における版
153行目:		153行目:
	コマンドラインオプションの説明や、サービスをスタンドアロンのプロセスとして実行する方法の詳細については、サービスのドキュメントまたは {{ic\|python -m jupyterhub_idle_culler --help}} の出力を参照してください。		コマンドラインオプションの説明や、サービスをスタンドアロンのプロセスとして実行する方法の詳細については、サービスのドキュメントまたは {{ic\|python -m jupyterhub_idle_culler --help}} の出力を参照してください。

	== ~~Tips and Tricks~~ ==		== ヒントとコツ ==

			=== ルートユーザーとしての実行 ===
	=== Running as non-root user ===

			デフォルトでは、メインの hub プロセスはルートユーザーとして実行されます（個々のユーザーサーバーは、spawner によって設定された対応するローカルユーザーとして実行されます）。非ルートユーザーとして実行するには、[[#SudoSpawner\|SudoSpawner]] を使用する必要があります（上記の他の spawners はルートとしての実行が必要です）。PAM 認証を使用している場合は、非ルートユーザー用に[[#PAM authentication as non-root user\|それを設定する]]必要もあります。
	By default, the main hub process is run as the root user (the individual user servers are run under the corresponding local user as set by the spawner). To run as a non-root user, you need to use the [[#SudoSpawner\|SudoSpawner]] (the other spawners listed above require running as root). If you are using the PAM authenticator, you will also need to [[#PAM authentication as non-root user\|configure it for a non-root user]].

			=== リバースプロキシの使用 ===
	=== Using a reverse proxy ===

	~~A reverse proxy can be used to redirect external requests to the~~ JupyterHub ~~instance. This can be useful if you want to serve multiple sites from one machine, or use an existing server to handle~~ [[SSL]]. ~~The~~ [https://jupyterhub.readthedocs.io/en/stable/reference/config-proxy.html ~~using a reverse proxy~~] ~~section of the JupyterHub documentation has example configuration for using either~~ [[nginx]] or [[Apache HTTP Server\|Apache]] ~~as a reverse proxy.~~		リバースプロキシは、外部のリクエストを JupyterHub インスタンスにリダイレクトするために使用できます。これは、1台のマシンから複数のサイトを提供したい場合や、既存のサーバーを使用して[[SSL]] を処理したい場合に便利です。JupyterHub のドキュメントの [https://jupyterhub.readthedocs.io/en/stable/reference/config-proxy.html リバースプロキシの使用] セクションには、リバースプロキシとして[[nginx]] または[[Apache HTTP Server\|Apache]] を使用するためのサンプル設定があります。

			{{Note\|これは JupyterHub のプロキシコンポーネントを置き換えるものではありません。これは、メインの hub またはシングルユーザーサーバーのどちらかにリクエストをルーティングするためのものです。むしろ、リバースプロキシは外部のリクエストを JupyterHub のプロキシに渡します。}}
	{{Note\|This does not replace the proxy component of JupyterHub which is responsible for routing requests to either the main hub or the single-user servers. Rather, the reverse proxy passes external requests to the JupyterHub proxy.}}

			=== 他のウェブサービスをプロキシする ===
	=== Proxy other web services ===

	~~The~~ Jupyter Server Proxy ~~extension allows you to run other web services such as~~ Code Server or RStudio ~~alongside~~ JupyterHub ~~and provide authenticated web access to them. To use it, install~~ {{AUR\|python-jupyter-server-proxy}} ~~and configure it with the~~ {{ic\|/etc/jupyter/jupyter_notebook_config.py}} ~~file. For instance, to proxy~~ {{AUR\|code-server}}:		Jupyter Server Proxy 拡張機能を使用すると、Code Server や RStudio などの他のウェブサービスを JupyterHub の隣に実行し、それらに対して認証付きのウェブアクセスを提供できます。使用するには、{{AUR\|python-jupyter-server-proxy}} をインストールし、{{ic\|/etc/jupyter/jupyter_notebook_config.py}} ファイルで設定します。例えば、{{AUR\|code-server}} をプロキシする場合:

	{{hc\|1=/etc/jupyter/jupyter_notebook_config.py\|2=		{{hc\|1=/etc/jupyter/jupyter_notebook_config.py\|2=
189行目:		189行目:
	}}		}}

	~~See~~ ~~the~~ [https://jupyter-server-proxy.readthedocs.io/en/latest/ ~~documentation~~] ~~for more details about configuring the Jupyter Server Proxy.~~		Jupyter Server Proxy の設定に関する詳細は、[https://jupyter-server-proxy.readthedocs.io/en/latest/ ドキュメント]を参照してください。

Kusanaginoturugi: /* Services */ 翻訳

2023-08-20T09:28:24Z

Services: 翻訳

← 古い版		2023年8月20日 (日) 18:28時点における版
128行目:		128行目:
	[https://github.com/jupyterhub/systemdspawner/blob/master/README.md#root-access systemdspawner の readme] によれば、現在、それを使用するには JupyterHub を root として実行する必要があります。		[https://github.com/jupyterhub/systemdspawner/blob/master/README.md#root-access systemdspawner の readme] によれば、現在、それを使用するには JupyterHub を root として実行する必要があります。

	== ~~Services~~ ==		== サービス ==

	A [https://jupyterhub.readthedocs.io/en/stable/getting-started/services-basics.html JupyterHub ~~service~~] is ~~defined as a process which interacts with the~~ Hub ~~through its API. Services can either be run by the~~ hub ~~or as standalone processes.~~		[https://jupyterhub.readthedocs.io/en/stable/getting-started/services-basics.html JupyterHub サービス] は、API を通じて Hub と対話するプロセスとして定義されています。サービスは、hub によって実行されるか、スタンドアロンのプロセスとして実行することができます。

	=== Idle ~~culler~~ ===		=== Idle culler（アイドルカラー） ===

	~~The~~ [https://github.com/jupyterhub/jupyterhub-idle-culler idle culler] ~~service can be used to automatically shut down idle single-user servers. To use it, install the~~ {{AUR\|jupyterhub-idle-culler}} ~~package. To run the service through the~~ hub~~, add a service description to the~~ {{ic\|c.JupyterHub.services}} ~~configuration variable:~~		[https://github.com/jupyterhub/jupyterhub-idle-culler idle culler] サービスは、アイドル状態のシングルユーザーサーバーを自動的にシャットダウンするために使用できます。使用するには、{{AUR\|jupyterhub-idle-culler}} パッケージをインストールしてください。hub を通じてサービスを実行するには、{{ic\|c.JupyterHub.services}} 設定変数にサービスの説明を追加してください：

	{{hc\|1=/etc/jupyterhub/jupyterhub_config.py\|2=		{{hc\|1=/etc/jupyterhub/jupyterhub_config.py\|2=
151行目:		151行目:
	}}		}}

			コマンドラインオプションの説明や、サービスをスタンドアロンのプロセスとして実行する方法の詳細については、サービスのドキュメントまたは {{ic\|python -m jupyterhub_idle_culler --help}} の出力を参照してください。
	See the service documentation or the output of {{ic\|python -m jupyterhub_idle_culler --help}} for a description of command-line options and details of how to run the service as a standalone process.

	== Tips and Tricks ==		== Tips and Tricks ==

Kusanaginoturugi: /* Spawners（スポーナー） */ スポーナーに統一

2023-08-20T09:25:20Z

Spawners（スポーナー）: スポーナーに統一

← 古い版		2023年8月20日 (日) 18:25時点における版
64行目:		64行目:
	== Spawners（スポーナー） ==		== Spawners（スポーナー） ==

	~~Spawners~~ は、各ユーザーのノートブックサーバーを起動し、監視する責任があります。[https://jupyterhub.readthedocs.io/en/stable/reference/spawners.html documentation] には、~~Spawners~~ の動作やカスタムスポーナーの作成方法についての詳しい情報が含まれています。[https://github.com/jupyterhub/jupyterhub/wiki/Spawners wiki page] には、いくつかの Spawners のリストがあり、その中には [[AUR]] パッケージがあるものも含まれ、以下で説明されています。		スポーナーは、各ユーザーのノートブックサーバーを起動し、監視する責任があります。[https://jupyterhub.readthedocs.io/en/stable/reference/spawners.html documentation] には、スポーナーの動作やカスタムスポーナーの作成方法についての詳しい情報が含まれています。[https://github.com/jupyterhub/jupyterhub/wiki/Spawners wiki page] には、いくつかの Spawners のリストがあり、その中には [[AUR]] パッケージがあるものも含まれ、以下で説明されています。

	=== LocalProcessSpawner ===		=== LocalProcessSpawner ===

Kusanaginoturugi: /* Spawners */ 翻訳

2023-08-20T09:18:51Z

Spawners: 翻訳

← 古い版		2023年8月20日 (日) 18:18時点における版
62行目:		62行目:
	}}		}}

			== Spawners（スポーナー） ==
	== Spawners ==

	Spawners ~~are responsible for starting and monitoring each user's notebook server. The~~ [https://jupyterhub.readthedocs.io/en/stable/reference/spawners.html ~~spawners section of the~~ documentation] ~~contains more details about how they work and how to write a custom spawner. The~~ [https://github.com/jupyterhub/jupyterhub/wiki/Spawners ~~spawners~~ wiki page] ~~has~~ a ~~list of spawners; some of these have~~ [[AUR]] ~~packages and are described below.~~		Spawners は、各ユーザーのノートブックサーバーを起動し、監視する責任があります。[https://jupyterhub.readthedocs.io/en/stable/reference/spawners.html documentation] には、Spawners の動作やカスタムスポーナーの作成方法についての詳しい情報が含まれています。[https://github.com/jupyterhub/jupyterhub/wiki/Spawners wiki page] には、いくつかの Spawners のリストがあり、その中には [[AUR]] パッケージがあるものも含まれ、以下で説明されています。

	=== LocalProcessSpawner ===		=== LocalProcessSpawner ===

			これは JupyterHub に含まれるデフォルトのスポーナーです。各シングルユーザーサーバーを、それぞれの[[ユーザーアカウント]]でローカルプロセスとして実行します（これは、各 JupyterHub ユーザーがローカルのユーザーアカウントに対応している必要があることを意味します）。また、異なるユーザーアカウントでプロセスを起動できるように、JupyterHub を root として実行する必要があります。このスポーナーを動作させるためには、{{Pkg\|jupyter-notebook}} パッケージがインストールされている必要があります。
	This is the default spawner included with JupyterHub. It runs each single-user server in a separate local process under their [[user account]] (this means each JupyterHub user must correspond to a local user account). It also requires JupyterHub to be run as root so it can spawn the processes under the different user accounts. The {{Pkg\|jupyter-notebook}} package must be installed for this spawner to work.

	=== SudoSpawner ===		=== SudoSpawner ===

	~~The~~ [https://github.com/jupyterhub/sudospawner SudoSpawner] ~~uses an intermediate process created with~~ [[sudo]] ~~to spawn the single-user servers. This allows the~~ JupyterHub ~~process to be~~ [[#Running as non-root user\|~~run~~ ~~as a non-~~root ~~user~~]]~~. To use it install the~~ {{AUR\|jupyterhub-sudospawner}} ~~package.~~		[https://github.com/jupyterhub/sudospawner SudoSpawner] は、[[sudo]] で作成された中間プロセスを使用して、シングルユーザーサーバーを起動します。これにより、JupyterHub プロセスを [[#Running as non-root user\|非 root ユーザーとして実行]] することができます。使用するには、{{AUR\|jupyterhub-sudospawner}} パッケージをインストールしてください。

			それを使用するために、[[ユーザーとグループ\|システムユーザーアカウントを作成]] してください（以下では、アカウントが {{ic\|jupyterhub}} という名前であると仮定しています）と、ハブにアクセスできるユーザーを定義するグループを作成します（ここでは、{{ic\|jupyterhub-users}} と呼ばれると仮定しています）。まず、{{ic\|jupyterhub}} ユーザーがパスワードなしでサーバーを起動できるように、sudo を設定する必要があります。[[sudo#Configure sudo using drop-in files in /etc/sudoers.d\|drop-in sudo 設定ファイル]] を [[sudo#Using visudo\|visudo]] で作成します。
	To use it, [[Users and groups\|create a system user account]] (the following assumes the account is named {{ic\|jupyterhub}}) and a group whose membership will define which users can access the hub (here assumed to be called {{ic\|jupyterhub-users}}). First, we have to configure sudo to allow the {{ic\|jupyterhub}} user to spawn a server without a password. Create a [[sudo#Configure sudo using drop-in files in /etc/sudoers.d\|drop-in sudo configuration file]] with [[sudo#Using visudo\|visudo]]:

	{{hc\|1=# visudo -f /etc/sudoers.d/jupyterhub-sudospawner\|2=		{{hc\|1=# visudo -f /etc/sudoers.d/jupyterhub-sudospawner\|2=
85行目:		85行目:
	}}		}}

			デフォルトのサービスファイルは、ハブを root として実行します。また、サービスの機能を制限するためのさまざまな強化オプションを適用します。この強化により、sudo が動作しなくなります。これを許可するためには、{{ic\|NoNewPrivileges}} サービスオプション（およびそれを暗黙的に設定する他のオプション、サービスオプションのリストについては {{man\|5\|systemd.exec}} を参照）をオフにする必要があります。{{ic\|jupyterhub}} ユーザーを使用してハブを実行するための[[ドロップインファイル]]を作成してください。
	The default service file runs the hub as root. It also applies a number of hardening options to the service to restrict its capabilities. This hardening prevents sudo from working; to allow it, the {{ic\|NoNewPrivileges}} service option (plus any other options which implicitly set it, see {{man\|5\|systemd.exec}} for a list of service options) needs to be off. Create a [[drop-in file]] to run the hub using the {{ic\|jupyterhub}} user instead:

	{{hc\|/etc/systemd/system/jupyterhub.service.d/override.conf\|2=		{{hc\|/etc/systemd/system/jupyterhub.service.d/override.conf\|2=
106行目:		106行目:
	}}		}}

	~~If you have previously run the hub as the~~ root ~~user, you will need to [[File permissions and attributes#Changing ownership\|change the ownership]] of the user database and~~ [https://jupyterhub.readthedocs.io/en/stable/getting-started/security-basics.html#cookie-secret cookie secret] ~~files:~~		以前、ハブを root ユーザーとして実行していた場合、ユーザーデータベースと [https://jupyterhub.readthedocs.io/en/stable/getting-started/security-basics.html#cookie-secret cookie secret] ファイルの[[ファイルのパーミッションと属性#所有者の変更\|所有者を変更]]する必要があります：

	# chown jupyterhub:jupyterhub /etc/jupyterhub/{jupyterhub_cookie_secret,jupyterhub.sqlite}		# chown jupyterhub:jupyterhub /etc/jupyterhub/{jupyterhub_cookie_secret,jupyterhub.sqlite}

	~~If you are using the~~ PAMAuthenticator~~, you will need to~~ [[#PAM authentication as non-root user\|~~configure~~ ~~your system to allow it to work as a non-~~root ~~user~~]].		PAMAuthenticator を使用している場合、[[#PAM authentication as non-root user\|非 root ユーザーとして動作するようにシステムを設定]]する必要があります。

			最後に、JupyterHub の設定を編集し、spawner クラスを SudoSpawner に変更します：
	Finally, edit the JupyterHub configuration and change the spawner class to SudoSpawner:

	{{hc\|1=/etc/jupyterhub/jupyterhub_config.py\|2=c.JupyterHub.spawner_class='sudospawner.SudoSpawner'}}		{{hc\|1=/etc/jupyterhub/jupyterhub_config.py\|2=c.JupyterHub.spawner_class='sudospawner.SudoSpawner'}}

			ユーザーにハブへのアクセス権を与えるには、そのユーザーを {{ic\|jupyterhub-users}} グループに追加します：
	To give a user access to the hub, add them to the {{ic\|jupyterhub-users}} group:

	# usermod -aG jupyterhub-users <username>		# usermod -aG jupyterhub-users <username>
122行目:		122行目:
	=== systemdspawner ===		=== systemdspawner ===

	~~The~~ [https://github.com/jupyterhub/systemdspawner systemdspawner] ~~uses~~ [[systemd]] ~~to manage each user's notebook which allows configuring resource limitations, better process isolation and sandboxing, and dynamically allocated users. To use it install the~~ {{AUR\|jupyterhub-systemdspawner}} ~~package and set the~~ spawner ~~class in the configuration file:~~		[https://github.com/jupyterhub/systemdspawner systemdspawner] は [[systemd]] を使用して、各ユーザーのノートブックを管理します。これにより、リソースの制限の設定、より良いプロセスの分離とサンドボックス化、動的に割り当てられたユーザーなどが可能になります。使用するには、{{AUR\|jupyterhub-systemdspawner}} パッケージをインストールし、設定ファイルで spawner クラスを設定します：

	{{hc\|1=/etc/jupyterhub/jupyterhub_config.py\|2=c.JupyterHub.spawner_class = 'systemdspawner.SystemdSpawner'}}		{{hc\|1=/etc/jupyterhub/jupyterhub_config.py\|2=c.JupyterHub.spawner_class = 'systemdspawner.SystemdSpawner'}}

	~~Note that as per~~ [https://github.com/jupyterhub/systemdspawner/blob/master/README.md#root-access systemdspawner's readme] ~~using it currently requires~~ JupyterHub to be ~~run as root.~~		[https://github.com/jupyterhub/systemdspawner/blob/master/README.md#root-access systemdspawner の readme] によれば、現在、それを使用するには JupyterHub を root として実行する必要があります。

	== Services ==		== Services ==

Kusanaginoturugi: /* PAM Authenticator */ 翻訳

2023-08-20T08:56:11Z

PAM Authenticator: 翻訳

← 古い版		2023年8月20日 (日) 17:56時点における版
35行目:		35行目:
	=== PAM Authenticator ===		=== PAM Authenticator ===

			PAM Authenticator は、[[PAM]] を使用してローカルユーザーがハブにログインできるようにします。これは JupyterHub に含まれており、デフォルトの Authenticator です。これを使用するには、ハブがユーザーパスワードのハッシュバージョンを含む {{ic\|/etc/shadow}} の読み取り権限を持っている必要があります。デフォルトでは、{{ic\|/etc/shadow}} は root が所有し、[[ユーザーとグループ#パーミッションと所有権\|ファイル権限]]は {{ic\|-rw------}} ですので、root としてハブを実行するとこの要件が満たされます。[[Fedora:Features/LowerProcessCapabilities\|一部の情報源]]は、{{ic\|/etc/shadow}} からすべての権限を削除して、侵害されたデーモンによって読み取られないようにし、アクセスが必要なプロセスに {{ic\|DAC_OVERRIDE}} [[ケイパビリティ]]を付与することを推奨しています。もしあなたの {{ic\|/etc/shadow}} がこのように設定されている場合、この機能を JupyterHub に付与するための[[ドロップインファイル]]を作成してください：
	The PAM authenticator uses [[PAM]] to allow local users to log in to the hub. It is included with JupyterHub and is the default authenticator. Using it requires the hub to have read permissions to {{ic\|/etc/shadow}} (which contains hashed versions of user passwords) in order to authenticate users. By default {{ic\|/etc/shadow}} is owned by root and has [[Users and groups#Permissions and ownership\|file permissions]] of {{ic\|-rw------}}, so running the hub as root will meet this requirement. [[Fedora:Features/LowerProcessCapabilities\|Some sources]] advocate removing all permissions from {{ic\|/etc/shadow}} so it cannot be read by compromised daemons, and granting processes which require access the {{ic\|DAC_OVERRIDE}} [[capabilities\|capability]]. If your {{ic\|/etc/shadow}} is set up like this, create a [[drop-in file]] for the service to grant this capability to JupyterHub:

	{{hc\|/etc/systemd/system/jupyterhub.service.d/override.conf\|2=		{{hc\|/etc/systemd/system/jupyterhub.service.d/override.conf\|2=
42行目:		42行目:
	}}		}}

	~~The~~ PAM ~~authenticator~~ ~~relies on the~~ Python ~~package~~ [https://github.com/minrk/pamela pamela]. ~~For basic troubleshooting this can be tested on the commandline. To attempt authentication as user~~ {{ic\|testuser}}, ~~run the following command:~~		PAM Authenticator は Python パッケージ [https://github.com/minrk/pamela pamela] に依存しています。基本的なトラブルシューティングはコマンドラインでテストすることができます。ユーザー {{ic\|testuser}} として認証を試みるには、次のコマンドを実行してください：

	# python -m pamela -a testuser		# python -m pamela -a testuser

			(JupyterHub を非 root ユーザーとして実行する場合は、root の代わりにそのユーザーとしてコマンドを実行してください)。認証が成功すると、出力は表示されません。失敗するとエラーメッセージが表示されます。
	(If you run JupyterHub as a non-root user, run the command as that user instead of root). If the authentication succeeds, no output will be printed. If it failed an error message will be printed.

	==== ~~PAM~~ ~~authentication~~ as ~~non-root~~ ~~user~~ ====		==== 非 root ユーザーとしての PAM 認証 ====

	~~If you run~~ JupyterHub as ~~a non-~~root ~~user, you will need to give that user read permissions to the~~ shadow ~~file. The~~ [https://jupyterhub.readthedocs.io/en/stable/reference/config-sudo.html#enable-pam-for-non-root ~~method recommended by the~~ JupyterHub ~~documentation~~] ~~is to create a~~ {{ic\|shadow}} ~~group, make the~~ shadow ~~file readable by this group, and add the~~ JupyterHub ~~user to this group.~~		JupyterHub を非 root ユーザーとして実行する場合、そのユーザーに shadow ファイルの読み取り権限を付与する必要があります。[https://jupyterhub.readthedocs.io/en/stable/reference/config-sudo.html#enable-pam-for-non-root JupyterHub のドキュメントで推奨されている方法]は、{{ic\|shadow}} グループを作成し、このグループに shadow ファイルを読み取り可能にし、JupyterHub ユーザーをこのグループに追加することです。

			{{Warning\|これにより、{{ic\|/etc/shadow}} 内のハッシュ化されたパスワードへの読み取り専用アクセスが JupyterHub ユーザーとしてコードを実行する全てのユーザーに許可されます。各単一ユーザーサーバーは自分のアカウントで実行されるため、それらのサーバーで実行されるコードはアクセス権を持っていないことに注意してください。また、JupyterHub のセキュリティエクスプロイトが root として JupyterHub を実行していた場合、同じハッシュ化されたパスワードへのアクセスが許可されることも注意してください。}}
	{{Warning\|This allows read-only access to the hashed passwords in {{ic\|/etc/shadow}} to anybody running code as the JupyterHub user. Note that each single-user server is run under their own account and so code executed in those servers will not have access. Also note that a security exploit in JupyterHub would allow the same access to the hashed passwords if JupyterHub was being run as root.}}

	Creating the group, modifying the shadow file permissions and adding the user {{ic\|jupyterhub}} to the group can be accomplished with the following four commands:

			グループを作成し、shadow ファイルの権限を変更し、ユーザー {{ic\|jupyterhub}} をグループに追加することは、次の4つのコマンドで実行できます：
	{{bc\|1=		{{bc\|1=
	# groupadd shadow		# groupadd shadow

Kusanaginoturugi: /* Authenticators */ 翻訳

2023-08-19T12:12:40Z

Authenticators: 翻訳

← 古い版		2023年8月19日 (土) 21:12時点における版
29行目:		29行目:
	== Authenticators ==		== Authenticators ==

	Authenticators ~~control access to the hub and the single-user servers. The~~ [https://jupyterhub.readthedocs.io/en/stable/reference/authenticators.html ~~authenticators~~ ~~section~~] of ~~the documentation contains details about how authenticators work and how to write a custom authenticator. The~~ [https://github.com/jupyterhub/jupyterhub/wiki/Authenticators ~~authenticators~~ wiki ~~page~~] ~~has a list of authenticators; some of these have~~ [[AUR]] ~~packages and are described below.~~		Authenticators はハブと単一ユーザーサーバへのアクセスを制御します。[https://jupyterhub.readthedocs.io/en/stable/reference/authenticators.html Authenticators セクション]のドキュメントには、Authenticators の動作方法やカスタム Authenticator の作成方法についての詳細が含まれています。[https://github.com/jupyterhub/jupyterhub/wiki/Authenticators Authenticators のwikiページ]には、Authenticators のリストがあり、その中には[[AUR]]パッケージを持つものもあり、以下で説明されています。

			ユーザーのステータスは、[https://jupyterhub.readthedocs.io/en/stable/getting-started/security-basics.html#cookie-secret cookie secret]によって暗号化されたクッキーに保存されていることに注意してください。異なる Authenticator に切り替える場合、または選択した Authenticator の設定を変更して許可されるユーザーのリストが変更される可能性がある場合は、cookie secretを変更する必要があります。これにより、現在のすべてのユーザーがログアウトされ、新しい設定で再認証を行う必要があります。これは、cookie secretファイルを削除してハブを再起動することで実行でき、新しいシークレットが自動的に生成されます。デフォルトの設定では、cookie secretは{{ic\|/etc/jupyterhub/jupyterhub_cookie_secret}}に保存されています。
	Note that user status is stored in cookies, encrypted by the [https://jupyterhub.readthedocs.io/en/stable/getting-started/security-basics.html#cookie-secret cookie secret]. If you switch to a different authenticator, or modify the settings of your chosen authenticator so that the list of allowed users might change, you should change the cookie secret. This logs out all current users and forces them to re-authenticate with your new settings. This can be performed by deleting the cookie secret file and restarting the hub which will automatically generate a new secret. With the default configuration, the cookie secret is stored at {{ic\|/etc/jupyterhub/jupyterhub_cookie_secret}}.

	=== PAM Authenticator ===		=== PAM Authenticator ===

Kusanaginoturugi: TranslationStatus は飜訳がおわってから追加する。

2023-02-15T04:44:50Z

TranslationStatus は飜訳がおわってから追加する。

← 古い版		2023年2月15日 (水) 13:44時点における版
191行目:		191行目:

	See the [https://jupyter-server-proxy.readthedocs.io/en/latest/ documentation] for more details about configuring the Jupyter Server Proxy.		See the [https://jupyter-server-proxy.readthedocs.io/en/latest/ documentation] for more details about configuring the Jupyter Server Proxy.

	{{TranslationStatus\|JupyterHub\|2023-02-13\|764978}}

Kusanaginoturugi: /* Configuration */ 飜訳

2023-02-15T01:38:31Z

Configuration: 飜訳

← 古い版		2023年2月15日 (水) 10:38時点における版
19行目:		19行目:
	{{ic\|jupyterhub.service}} を[[開始/有効化]]します。デフォルトの設定では、ブラウザで 127.0.0.1:8000 にアクセスしてハブにアクセスできます。		{{ic\|jupyterhub.service}} を[[開始/有効化]]します。デフォルトの設定では、ブラウザで 127.0.0.1:8000 にアクセスしてハブにアクセスできます。

	== ~~Configuration~~ ==		== 設定 ==

			JupyterHub の設定ファイルは {{ic\|/etc/jupyterhub/jupyterhub_config.py}} に置かれています。これは、設定オブジェクト {{ic\|c}} を変更する Python スクリプトです。パッケージが提供する設定ファイルには、利用可能な設定オプションとそのデフォルト値が表示されます。
	The JupyterHub configuration file is located at {{ic\|/etc/jupyterhub/jupyterhub_config.py}}. This is a Python script which modifies the configuration object {{ic\|c}}. The configuration file provided by the package shows the available configuration options and their default values.

	~~Any relative paths in the configuration are resolved from the working directory that the hub is run from. The~~ systemd ~~service provided by the package uses~~ {{ic\|/etc/jupyterhub}} ~~as the working directory. This means, for example, that the default database~~ URL {{ic\|1=c.JupyterHub.db_url = 'sqlite:///jupyterhub.sqlite'}} ~~corresponds to the file~~ {{ic\|/etc/jupyterhub/jupyterhub.sqlite}}.		設定中の相対パスは、ハブが実行される作業ディレクトリから解決されます。パッケージが提供する systemd サービスは作業ディレクトリとして {{ic\|/etc/jupyterhub}} を使用します。これは、例えばデフォルトのデータベース URL {{ic\|1=c.JupyterHub.db_url = 'sqlite:///jupyterhub.sqlite'}} がファイル {{ic\|/etc/jupyterhub/jupyterhub.sqlite}} に対応することを意味しています。

	~~All configuration options can be overridden on the command line. For example, the configuration file setting~~ {{ic\|1=c.Application.show_config = True}} ~~could instead be set with the command line flag~~ {{ic\|1=--Application.show_config=True}}. ~~Note that the provided~~ systemd ~~service uses the command line to explicitly set the~~ {{ic\|c.JupyterHub.pid_file}} ~~and~~ {{ic\|c.ConfigurableHTTPProxy.pid_file}} ~~values to a suitable runtime directory so any values for them in the configuration file will be ignored.~~		全ての設定オプションはコマンドライン上で上書きすることができます。例えば、設定ファイルの設定 {{ic\|1=c.Application.show_config = True}} は、代わりにコマンドラインフラグ {{ic\|1=--Application.show_config=True}} で設定することが可能です。提供される systemd サービスはコマンドラインを使用して {{ic\|c.JupyterHub.pid_file}} と {{ic\|c.ConfigurableHTTPProxy.pid_file}} をランタイムのディレクトリに明示的に設定するので、設定ファイルにそれらの値があっても無視されることに注意しましょう。

	== Authenticators ==		== Authenticators ==

Kusanaginoturugi: /* Running */ 飜訳

2023-02-14T01:08:26Z

Running: 飜訳

← 古い版		2023年2月14日 (火) 10:08時点における版
15行目:		15行目:
	{{AUR\|jupyterhub}} パッケージを[[インストール]]します。ほとんどの場合、{{Pkg\|jupyter-notebook}} パッケージもインストールする必要があります（より高度な [[#Spawners\|spawners]] は必要ない場合もあります）。また、{{Pkg\|jupyterlab}} パッケージをインストールすると、[https://jupyterlab.readthedocs.io/ JupyterLab] インターフェイスを利用できるようになります。		{{AUR\|jupyterhub}} パッケージを[[インストール]]します。ほとんどの場合、{{Pkg\|jupyter-notebook}} パッケージもインストールする必要があります（より高度な [[#Spawners\|spawners]] は必要ない場合もあります）。また、{{Pkg\|jupyterlab}} パッケージをインストールすると、[https://jupyterlab.readthedocs.io/ JupyterLab] インターフェイスを利用できるようになります。

	== ~~Running~~ ==		== 起動 ==

	~~[[Start/enable]]~~ {{ic\|jupyterhub.service}}. ~~With the default configuration you can access the hub by going to~~ 127.0.0.1:8000 ~~in your browser.~~		{{ic\|jupyterhub.service}} を[[開始/有効化]]します。デフォルトの設定では、ブラウザで 127.0.0.1:8000 にアクセスしてハブにアクセスできます。

	== Configuration ==		== Configuration ==