オーバーレイ

From Gentoo Wiki
Jump to: navigation, search
This page is a translated version of the page Ebuild repository and the translation is 59% complete.

Other languages:
English • ‎español • ‎français • ‎日本語 • ‎한국어 • ‎polski • ‎русский • ‎中文(中国大陆)‎
Resources

An ebuild repository, colloquially known as an overlay, is a structure of directories and files used to add and extend packages available to the system's package manager. Ebuild repositories are also used by Gentoo developers as training ground and staging area for new ebuilds. Ebuild repositories can contain ebuilds of one or more EAPIs.

Systems that have Gentoo installed typically have a single ebuild repository available on the system. This main repository, known as the Gentoo ebuild repository, contains ebuilds maintained by official Gentoo developers and members of the community (through the Proxy Maintainers project). System administrators can add additional ebuild repositories to the system using various utilities and methods described below.

リポジトリ

Ebuild repositories are nothing more (or less) than a set of files (ebuilds, metadata files, ...). These can be pulled in from public repositories (git, CVS, SVN ...) or downloaded as tarballs and extracted manually onto the system. It is advised to use managed repositories by trusted third parties; any installed ebuild repository will cause Portage to look through the overlaid files when deciding which software to install. If compromised code is in the ebuild repository, then compromised packages could be installed on the system.

The now default approach for handling repositories is through /etc/portage/repos.conf which, like many other Portage related locations, can be a directory as well.

Repository definitions inside /etc/portage/repos.conf/ also inform Portage if and how the repository can be updated. With it, calling emerge --sync will automatically update the repositories as well.

A deprecated, yet still supported method is to use the PORTDIR_OVERLAY variable inside /etc/portage/make.conf. This variable can point to one or more additional locations on the file system where repositories are available. The use of the /etc/portage/repos.conf/ directory is highly preferred.

より詳しくは、 /etc/portage/repos.conf 及び Portage/Sync の記事を参照してください

優先順位について

それぞれのebuildリポジトリは、固有の優先度を保持します。特定のバージョンが複数のebuildリポジトリ内に見つかって処理方法が不明確になった場合に備えるための仕様です。優先度値のより高い(たとえば60)ebuildリポジトリ内の ebuild が、優先度の低い(たとえば50)ebuildリポジトリ内の ebuild に先んじて処理されます。

優先度を含んだebuildリポジトリのリストは、以下のコマンドの出力で得られます("Repositories"の欄を探してください):

user $emerge --info --verbose
user $portageq repos_config /

Gentoo リポジトリには -1000 という優先度が設定されます。すなわち、他のすべてのebuildリポジトリのほうに高い優先度が割り当てられているので、これらが先んじて処理されます。この挙動は既定の仕様です。なぜなら、ebuildリポジトリとは、Gentooリポジトリの上に覆い被せる (lay over/on top) ように設計されたものなのですから。

各種ソフトウェア

多くのツールがebuildリポジトリをサポート、または統合的に扱っています。

Layman

laymanアプリケーションは、複数の追加ebuildリポジトリを更新・管理することを容易にします。laymanはコマンドラインアプリケーションで、laymanを通じて公に利用可能なebuildリポジトリを一覧表示、購読、購読解除、更新することができます。

It supports both the make.conf as well as repos.conf method.

より詳しくは Layman の記事及びProject:Portage/Sync#Layman_configuration を参照してください。

emaint

Sync (Portage project) 記事および man 1 emaint を参照してください。

eix

eix-sync is a wrapper starting emerge --sync (which in turn starts emaint sync --auto) followed by eix-update. For further details see the Eix article and man 1 eix.

Usage

Emerging a duplicate package

When working with ebuild repositories it is possible to encounter a situation where multiple versions of the same package are available from different ebuild repositories. Instruct Portage to install a specific package from a specific ebuild repository with the :: notation:

root #emerge --ask category/atom::repository-name

The same notation can be used for different emerge instructions, including uninstalling a package through --depclean.

Best practices

キャッシュの生成について

portage は、ebuildリポジトリが多量にインストールされている場合には、パッケージの前提関係を解決するような処理に長い時間を要するかもしれません。これは、ebuildリポジトリには一般的に、メタデータキャッシュが含まれていないためです。

ローカルのメタデータキャッシュを生成するには、ebuildリポジトリとの同期後に emerge --regen を実行してください:

root #layman -S
root #( ulimit -n 4096 && emerge --regen )

Be careful, because emerge --regen takes a lot of time and it's not recommended for rsync users as rsync updates the cache using server-side caches (most of users of portage are rsync users). Rsync users should simply run emerge --sync (or eix-sync) to regenerate the cache. It's probably only users of very large ebuild repositories should try emerge --regen.

Masking installed but unsafe ebuild repositories

巨大なebuildリポジトリや、よく知らない・低品質なebuildリポジトリを利用するなら、そのebuildリポジトリ全体に対してハードマスクをかけるのが最善でしょう。

FILE /etc/portage/package.mask
*/*::ebuild repository-name

その後に、インストールするパッケージのマスクを外します。

FILE /etc/portage/package.unmask
foo/bar::ebuild repository-name

参考

外部の情報