ウェブアプリケーションパッケージガイドライン - 版の履歴

AshMyzk: accuracy の文章を微修正

2022-04-11T03:21:49Z

accuracy の文章を微修正

← 古い版		2022年4月11日 (月) 12:21時点における版
2行目:		2行目:
	[[en:Web application package guidelines]]		[[en:Web application package guidelines]]
	[[pt:Web application package guidelines]]		[[pt:Web application package guidelines]]
	{{Accuracy\| 以下のファイルシステムレイアウトは~~1つよりも多く~~のウェブアプリにおいて不十分です。}}		{{Accuracy\| 以下のファイルシステムレイアウトは実際の複数のウェブアプリにおいて不十分です。}}
	{{Package Guidelines}}		{{Package Guidelines}}
	このページではウェブアプリケーションをパッケージ化する方法を説明します。		このページではウェブアプリケーションをパッケージ化する方法を説明します。

AshMyzk: /* ディレクトリ構造 */ 微修正

2022-04-11T03:20:28Z

ディレクトリ構造: 微修正

← 古い版		2022年4月11日 (月) 12:20時点における版
21行目:		21行目:
	* {{ic\|/etc/''$pkgname''}}: アプリケーションの''設定ディレクトリ''にはウェブアプリケーションの設定ファイルが格納されます(''データディレクトリ''へのシンボリックリンクとなります)。ここに位置するファイルは [[PKGBUILD#backup\|backup 配列]] に含まれていなければならず、{{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています。		* {{ic\|/etc/''$pkgname''}}: アプリケーションの''設定ディレクトリ''にはウェブアプリケーションの設定ファイルが格納されます(''データディレクトリ''へのシンボリックリンクとなります)。ここに位置するファイルは [[PKGBUILD#backup\|backup 配列]] に含まれていなければならず、{{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています。

	:{{Warning\| 認証情報を含んでいる可能性のあるファイルは''保護されていなければなりません''。(つまり、システム上のいかなるユーザやグループからも読み取り可能であってはなりません。ただし、{{ic\|root}} と {{ic\|''$pkgname''}} は例外です。)!}}		:{{Warning\| 認証情報を含んでいる可能性のあるファイルは''保護されていなければなりません''!(つまり、システム上のいかなるユーザやグループからも読み取り可能であってはなりません。ただし、{{ic\|root}} と {{ic\|''$pkgname''}} は例外です。)}}

	* {{ic\|/run/''$pkgname''}}: アプリケーションの''ランタイムディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。ソケット用に利用可能です(例えば、[[UWSGI#Socket_activation\|ソケットアクティベーション]]を容易にするセットアップで)。		* {{ic\|/run/''$pkgname''}}: アプリケーションの''ランタイムディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。ソケット用に利用可能です(例えば、[[UWSGI#Socket_activation\|ソケットアクティベーション]]を容易にするセットアップで)。

AshMyzk: translateme を削除

2022-04-11T03:18:33Z

translateme を削除

← 古い版		2022年4月11日 (月) 12:18時点における版
1行目:		1行目:
	{{Translateme\|飜訳が必要です。}}
	[[Category:パッケージ開発]]		[[Category:パッケージ開発]]
	[[en:Web application package guidelines]]		[[en:Web application package guidelines]]

AshMyzk: accuracy を追加

2022-04-11T03:18:10Z

accuracy を追加

← 古い版		2022年4月11日 (月) 12:18時点における版
3行目:		3行目:
	[[en:Web application package guidelines]]		[[en:Web application package guidelines]]
	[[pt:Web application package guidelines]]		[[pt:Web application package guidelines]]
			{{Accuracy\| 以下のファイルシステムレイアウトは1つよりも多くのウェブアプリにおいて不十分です。}}
	{{Package Guidelines}}		{{Package Guidelines}}
	このページではウェブアプリケーションをパッケージ化する方法を説明します。		このページではウェブアプリケーションをパッケージ化する方法を説明します。

AshMyzk: /* ディレクトリ構造 */ 翻訳

2022-04-11T03:14:02Z

ディレクトリ構造: 翻訳

← 古い版		2022年4月11日 (月) 12:14時点における版
15行目:		15行目:
	==ディレクトリ構造==		==ディレクトリ構造==

			ディレクトリ構造は [[FHS]] に従います。
	The layout follows the [[FHS]].

			* {{ic\|/usr/share/''$pkgname''}}: アプリケーションの''データディレクトリ''にはウェブアプリケーションのファイルが格納されます。ファイルは {{ic\|root}} が所有しており、ゆえに {{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループに対しては読み取り専用となります。
	* {{ic\|/usr/share/''$pkgname''}}: The application's ''data directory'' holds the files of the web application. Files are owned by {{ic\|root}} and are therefore readonly to the application user and group {{ic\|''$pkgname''}}.
	* {{ic\|/etc/''$pkgname''}}: The ''configuration directory'' of the application holds configuration files for the application (symlinked to the ''data directory''). Files located here have to go to the [[PKGBUILD#backup\|backup]] array and are owned by the user and group {{ic\|''$pkgname''}}.

			* {{ic\|/etc/''$pkgname''}}: アプリケーションの''設定ディレクトリ''にはウェブアプリケーションの設定ファイルが格納されます(''データディレクトリ''へのシンボリックリンクとなります)。ここに位置するファイルは [[PKGBUILD#backup\|backup 配列]] に含まれていなければならず、{{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています。
	:{{Warning\| Files potentially containing authentication information '''must be protected''' (i.e. not readable by any other user or group on the system, except {{ic\|root}} and {{ic\|''$pkgname''}})!}}

			:{{Warning\| 認証情報を含んでいる可能性のあるファイルは''保護されていなければなりません''。(つまり、システム上のいかなるユーザやグループからも読み取り可能であってはなりません。ただし、{{ic\|root}} と {{ic\|''$pkgname''}} は例外です。)!}}
	* {{ic\|/run/''$pkgname''}}: The ''runtime directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It can be used for sockets (e.g. in setups facilitating [[UWSGI#Socket_activation\|socket activation]]).
	:{{Note\| According to the package guidelines on [[Arch_パッケージガイドライン#ディレクトリ\|ディレクトリ]], {{ic\|/run}} must not be contained in a package. Use [[tmpfiles]] to add the directory with matching permissions.}}

			* {{ic\|/run/''$pkgname''}}: アプリケーションの''ランタイムディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。ソケット用に利用可能です(例えば、[[UWSGI#Socket_activation\|ソケットアクティベーション]]を容易にするセットアップで)。
	* {{ic\|/var/cache/''$pkgname''}}: The ''cache directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring writable cache directories.

	* {{ic\|/var/lib/''$pkgname''}}: The ''persistent storage'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring persistent storage directories.
			:{{Note\| [[Arch_パッケージガイドライン#ディレクトリ\|ディレクトリ]]のパッケージガイドラインによれば、{{ic\|/run}} はパッケージに含まれていてはいけません。[[tmpfiles]] を使って適切なパーミッションを持つディレクトリを作成してください。}}

			* {{ic\|/var/cache/''$pkgname''}}: アプリケーションの''キャッシュディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。このフォルダ(あるいは、この中のサブフォルダ)は、書き込み可能なキャッシュディレクトリを必要とするアプリケーション用に''データディレクトリ''へのシンボリックリンクとなります。.

			* {{ic\|/var/lib/''$pkgname''}}: アプリケーションの''永続的ストレージ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。このフォルダ(あるいは、この中のサブフォルダ)は、永続的なストレージディレクトリを必要とするアプリケーション用に''データディレクトリ''へのシンボリックリンクとなります。

AshMyzk: /* ユーザの分離 */ 翻訳

2022-04-11T01:25:48Z

ユーザの分離: 翻訳

← 古い版		2022年4月11日 (月) 10:25時点における版
5行目:		5行目:
	{{Package Guidelines}}		{{Package Guidelines}}
	このページではウェブアプリケーションをパッケージ化する方法を説明します。		このページではウェブアプリケーションをパッケージ化する方法を説明します。
	== ~~Separate user~~ ==		== ユーザの分離 ==

			セキュリティ上の理由により、すべてのウェブアプリケーションは別々の(非特権)ユーザ(つまり、{{ic\|''$pkgname''}})として実行されるべきです。
	For security reasons, every web application should be run as a separate (unprivileged) user (i.e. {{ic\|''$pkgname''}}).

			{{Note\|以前は多くのウェブアプリケーションが {{ic\|http}} ユーザ/グループとして実行されていました。この場合、アプリケーションが互いのファイルを読むことができるので安全でないと考えられます。}}
	{{Note\| Traditionally, many web applications were run as the {{ic\|http}} user/group, which can be considered unsafe, as in such a scenario applications can read each other's files.}}

	~~Refer to the~~ {{man\|8\|systemd-sysusers}}, {{man\|5\|sysusers.d}}, {{man\|8\|systemd-tmpfiles}} ~~and~~ {{man\|5\|tmpfiles.d}} ~~man pages for details on how to create users and deal with ownership of files and folders for that user in a package.~~		ユーザの作成方法や、パッケージのユーザ用のファイルやフォルダーの所有権をどう扱うかについては、{{man\|8\|systemd-sysusers}} や {{man\|5\|sysusers.d}}、{{man\|8\|systemd-tmpfiles}}、{{man\|5\|tmpfiles.d}} を参照してください。

	==ディレクトリ構造==		==ディレクトリ構造==

Kusanaginoturugi: /* ディレクトリ構造 */ リンクを修正

2021-09-30T06:35:37Z

ディレクトリ構造: リンクを修正

← 古い版		2021年9月30日 (木) 15:35時点における版
23行目:		23行目:

	* {{ic\|/run/''$pkgname''}}: The ''runtime directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It can be used for sockets (e.g. in setups facilitating [[UWSGI#Socket_activation\|socket activation]]).		* {{ic\|/run/''$pkgname''}}: The ''runtime directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It can be used for sockets (e.g. in setups facilitating [[UWSGI#Socket_activation\|socket activation]]).
	:{{Note\| According to the package guidelines on [[~~Arch_package_guidelines~~#~~Directories~~\|~~directories~~]], {{ic\|/run}} must not be contained in a package. Use [[tmpfiles]] to add the directory with matching permissions.}}		:{{Note\| According to the package guidelines on [[Arch_パッケージガイドライン#ディレクトリ\|ディレクトリ]], {{ic\|/run}} must not be contained in a package. Use [[tmpfiles]] to add the directory with matching permissions.}}

	* {{ic\|/var/cache/''$pkgname''}}: The ''cache directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring writable cache directories.		* {{ic\|/var/cache/''$pkgname''}}: The ''cache directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring writable cache directories.

2021年9月30日 (木) 06:33にKusanaginoturugiによる

2021-09-30T06:33:16Z

@@ 1行目: / 1行目: @@
-{{Translateme|記事の追加と飜訳が必要です。}}
+{{Translateme|飜訳が必要です。}}
 [[Category:パッケージ開発]]
 [[en:Web application package guidelines]]
 {{Package Guidelines}}
 このページではウェブアプリケーションをパッケージ化する方法を説明します。
 ==ディレクトリ構造==

2021年9月30日 (木) 06:30にKusanaginoturugiによる

2021-09-30T06:30:55Z

← 古い版		2021年9月30日 (木) 15:30時点における版
1行目:		1行目:
			{{Translateme\|記事の追加と飜訳が必要です。}}
	[[Category:パッケージ開発]]		[[Category:パッケージ開発]]
	[[en:Web application package guidelines]]		[[en:Web application package guidelines]]

Kusakata: ページの作成:「Category:パッケージ開発 en:Web application package guidelines {{Package Guidelines}} このページではウェブアプリケーションをパッケー...」

2016-08-18T13:51:41Z

ページの作成:「Category:パッケージ開発 en:Web application package guidelines {{Package Guidelines}} このページではウェブアプリケーションをパッケー...」

新規ページ

[[Category:パッケージ開発]]
[[en:Web application package guidelines]]
{{Package Guidelines}}

このページではウェブアプリケーションをパッケージ化する方法を説明します。

==ディレクトリ構造==
レイアウトの例:

* {{Ic|/etc/webapps/''$pkgname''}}
* {{Ic|/usr/share/webapps/''$pkgname''}}

← 古い版		2022年4月11日 (月) 12:20時点における版
21行目:		21行目:
	* {{ic\|/etc/''$pkgname''}}: アプリケーションの''設定ディレクトリ''にはウェブアプリケーションの設定ファイルが格納されます(''データディレクトリ''へのシンボリックリンクとなります)。ここに位置するファイルは [[PKGBUILD#backup\|backup 配列]] に含まれていなければならず、{{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています。		* {{ic\|/etc/''$pkgname''}}: アプリケーションの''設定ディレクトリ''にはウェブアプリケーションの設定ファイルが格納されます(''データディレクトリ''へのシンボリックリンクとなります)。ここに位置するファイルは [[PKGBUILD#backup\|backup 配列]] に含まれていなければならず、{{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています。

	:{{Warning\| 認証情報を含んでいる可能性のあるファイルは''保護されていなければなりません''。(つまり、システム上のいかなるユーザやグループからも読み取り可能であってはなりません。ただし、{{ic\|root}} と {{ic\|''$pkgname''}} は例外です。)!}}		:{{Warning\| 認証情報を含んでいる可能性のあるファイルは''保護されていなければなりません''!(つまり、システム上のいかなるユーザやグループからも読み取り可能であってはなりません。ただし、{{ic\|root}} と {{ic\|''$pkgname''}} は例外です。)}}

	* {{ic\|/run/''$pkgname''}}: アプリケーションの''ランタイムディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。ソケット用に利用可能です(例えば、[[UWSGI#Socket_activation\|ソケットアクティベーション]]を容易にするセットアップで)。		* {{ic\|/run/''$pkgname''}}: アプリケーションの''ランタイムディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。ソケット用に利用可能です(例えば、[[UWSGI#Socket_activation\|ソケットアクティベーション]]を容易にするセットアップで)。

← 古い版		2022年4月11日 (月) 12:14時点における版
15行目:		15行目:
	==ディレクトリ構造==		==ディレクトリ構造==

			ディレクトリ構造は [[FHS]] に従います。
	The layout follows the [[FHS]].

			* {{ic\|/usr/share/''$pkgname''}}: アプリケーションの''データディレクトリ''にはウェブアプリケーションのファイルが格納されます。ファイルは {{ic\|root}} が所有しており、ゆえに {{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループに対しては読み取り専用となります。
	* {{ic\|/usr/share/''$pkgname''}}: The application's ''data directory'' holds the files of the web application. Files are owned by {{ic\|root}} and are therefore readonly to the application user and group {{ic\|''$pkgname''}}.
	* {{ic\|/etc/''$pkgname''}}: The ''configuration directory'' of the application holds configuration files for the application (symlinked to the ''data directory''). Files located here have to go to the [[PKGBUILD#backup\|backup]] array and are owned by the user and group {{ic\|''$pkgname''}}.

			* {{ic\|/etc/''$pkgname''}}: アプリケーションの''設定ディレクトリ''にはウェブアプリケーションの設定ファイルが格納されます(''データディレクトリ''へのシンボリックリンクとなります)。ここに位置するファイルは [[PKGBUILD#backup\|backup 配列]] に含まれていなければならず、{{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています。
	:{{Warning\| Files potentially containing authentication information '''must be protected''' (i.e. not readable by any other user or group on the system, except {{ic\|root}} and {{ic\|''$pkgname''}})!}}

			:{{Warning\| 認証情報を含んでいる可能性のあるファイルは''保護されていなければなりません''。(つまり、システム上のいかなるユーザやグループからも読み取り可能であってはなりません。ただし、{{ic\|root}} と {{ic\|''$pkgname''}} は例外です。)!}}
	* {{ic\|/run/''$pkgname''}}: The ''runtime directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It can be used for sockets (e.g. in setups facilitating [[UWSGI#Socket_activation\|socket activation]]).
	:{{Note\| According to the package guidelines on [[Arch_パッケージガイドライン#ディレクトリ\|ディレクトリ]], {{ic\|/run}} must not be contained in a package. Use [[tmpfiles]] to add the directory with matching permissions.}}

			* {{ic\|/run/''$pkgname''}}: アプリケーションの''ランタイムディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。ソケット用に利用可能です(例えば、[[UWSGI#Socket_activation\|ソケットアクティベーション]]を容易にするセットアップで)。
	* {{ic\|/var/cache/''$pkgname''}}: The ''cache directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring writable cache directories.

	* {{ic\|/var/lib/''$pkgname''}}: The ''persistent storage'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring persistent storage directories.
			:{{Note\| [[Arch_パッケージガイドライン#ディレクトリ\|ディレクトリ]]のパッケージガイドラインによれば、{{ic\|/run}} はパッケージに含まれていてはいけません。[[tmpfiles]] を使って適切なパーミッションを持つディレクトリを作成してください。}}

			* {{ic\|/var/cache/''$pkgname''}}: アプリケーションの''キャッシュディレクトリ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。このフォルダ(あるいは、この中のサブフォルダ)は、書き込み可能なキャッシュディレクトリを必要とするアプリケーション用に''データディレクトリ''へのシンボリックリンクとなります。.

			* {{ic\|/var/lib/''$pkgname''}}: アプリケーションの''永続的ストレージ''です({{ic\|''$pkgname''}} ユーザと {{ic\|''$pkgname''}} グループが所有しています)。このフォルダ(あるいは、この中のサブフォルダ)は、永続的なストレージディレクトリを必要とするアプリケーション用に''データディレクトリ''へのシンボリックリンクとなります。

← 古い版		2021年9月30日 (木) 15:35時点における版
23行目:		23行目:

	* {{ic\|/run/''$pkgname''}}: The ''runtime directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It can be used for sockets (e.g. in setups facilitating [[UWSGI#Socket_activation\|socket activation]]).		* {{ic\|/run/''$pkgname''}}: The ''runtime directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It can be used for sockets (e.g. in setups facilitating [[UWSGI#Socket_activation\|socket activation]]).
	:{{Note\| According to the package guidelines on [[~~Arch_package_guidelines~~#~~Directories~~\|~~directories~~]], {{ic\|/run}} must not be contained in a package. Use [[tmpfiles]] to add the directory with matching permissions.}}		:{{Note\| According to the package guidelines on [[Arch_パッケージガイドライン#ディレクトリ\|ディレクトリ]], {{ic\|/run}} must not be contained in a package. Use [[tmpfiles]] to add the directory with matching permissions.}}

	* {{ic\|/var/cache/''$pkgname''}}: The ''cache directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring writable cache directories.		* {{ic\|/var/cache/''$pkgname''}}: The ''cache directory'' of the application (owned by the user and group {{ic\|''$pkgname''}}). It (or subfolders in it) is symlinked to the ''data directory'' for applications requiring writable cache directories.