diff --git a/debian-cd/README.devel.txt b/debian-cd/README.devel.txt new file mode 100644 index 0000000..8fea8b8 --- /dev/null +++ b/debian-cd/README.devel.txt @@ -0,0 +1,60 @@ +README for those who want to hack on debian-cd +---------------------------------------------- + +Organisation : +-------------- + +The main source is in the Debian git server. If you want to hack on +debian-cd and if you want to send me patches, please work on the +latest version available in git. +主なソースは Debian git サーバにあります。debian-cd をハックしたい場合やパッチを私に送りたい場合は、 git で利用可能な最新バージョンで作業してください。 + +auth: git@salsa.debian.org:images-team/debian-cd.git +anon: https://salsa.debian.org/images-team/debian-cd.git +web: https://salsa.debian.org/images-team/debian-cd + +If you want to discuss anything related to the debian-cd development, +mail the debian-cd@lists.debian.org mailing list where all people +interested in the debian-cd development are subscribed. +debian-cd 開発に関連したことを議論したい場合は、 debian-cd 開発に関心のある人たちが購読している debian-cd@lists.debian.org メーリングリストにメールを送ってください。 + +Technical details : +------------------- + +The Makefile which is the main directory will be used to launch +each step of the install process. Try to comment each target of +the makefile so that other can know why it's here. If you need +specific programs (perl or shell scripts), please put them +in the tools directory. +メインディレクトリにある Makefile は、インストールプロセスの各ステップを開始するのに使用されます。makefileの各ターゲットには、なぜそれがここにあるのかが他の人にもわかるようにコメントをつけるようにしてください。特定のプログラム（perlやシェルスクリプト）が必要な場合は、toolsディレクトリに置いてください。 + +The tasks directory will contain files listing packages (the +order in which package are listed is important, each package +added will be added to the current CD until it's full). +tasksディレクトリーには、パッケージの一覧ファイルが含まれます（パッケージの一覧の順番は重要で、追加されたパッケージは、現在のCDがいっぱいになるまで追加されます）。 + +The data dir will contains useful data (not directly task +related) like the master file from boot-floppies and so on. +データ・ディレクトリには、ブートフロッピーのマスターファイルなど、（タスクとは直接関係のない）役に立つデータが格納されています。 + +Each tool is self-documented, if you want to know what it +does read the sources (they are scripts). +各ツールはセルフ・ドキュメント化されているので、何をするのか知りたければソースを読んでほしい（スクリプトである）。 + +Debugging debian-cd : +--------------------- + +If you want to read more about what debian-cd is doing you can set the +VERBOSE environment variable to 1, 2 or 3 depending on the level of +noise that you want. +debian-cd が行っていることをもっと読みたければ、VERBOSE 環境変数を 1、2、3 のいずれかに設定してください。 + +Some scripts generates their own log files in the temp dir. You +can take a look at them if you want to check for warnings +and so on. +スクリプトによっては、tempディレクトリに独自のログファイルを生成するものもあります。警告などをチェックしたければ、それらを見ることができます。 +Log files : +- $TDIR/$CODENAME/sort_deps.log +- $TDIR/$CODENAME/make_disc_trees.log + + diff --git a/debian-cd/README.easy-build.txt b/debian-cd/README.easy-build.txt new file mode 100644 index 0000000..04380d1 --- /dev/null +++ b/debian-cd/README.easy-build.txt @@ -0,0 +1,399 @@ + debian-cd easy-build + ==================== + +INTRODUCTION +============ +easy-build.sh is a "wrapper" script around the more basic build.sh build +script. It is designed to make building a specific image or set or images +as easy as possible, while still offering all the flexibility of debian-cd. +easy-build.sh は、より基本的な build.sh ビルドスクリプトの「ラッパー」スクリプトです。これは、debian-cd の柔軟性をすべて提供しつつ、特定のイメージのビルドを 可能な限り簡単にするように設計されています。 + +easy-build.sh supports the following variations: +easy-build.shは以下のバリエーションをサポートしています： +- businesscard, netinst and full CD images, and DVD images +- single-architecture and multi-architecture images +- optionally include source packages +- select to install GNOME (default), KDE, LXDE or Xfce desktops as desktop + task +- create a combined LXDE/Xfce "light desktop" CD +- create a businesscard or netinst CD, or DVD set supporting all four + desktop environments +- creates ISO files by default; creating jigdo files is possible +- specify which Debian release to use +- include custom versions of packages (debs) +- specify which Debian Installer (D-I) version and source to use, including + custom images +- include custom versions of Debian Installer components (udebs) +- ビジネスカード、netinst、フルCDイメージ、DVDイメージ +- シングルアーキテクチャおよびマルチアーキテクチャ・イメージ +- オプションでソースパッケージを含める +- デスクトップ・タスクとして、GNOME（デフォルト）、KDE、LXDE、Xfce デスクトップのいずれかを選択してインストールできる +- LXDE/Xfce を組み合わせた "ライトデスクトップ" CD の作成 +- ビジネスカード、netinst CD、または 4 つのデスクトップ環境すべてをサポートする DVD セットを作成 +- デフォルトで ISO ファイルを作成; jigdo ファイルの作成も可能 +- 使われる Debian リリースを指定 +- カスタムバージョンのパッケージ (debs) を含める +- 使用する Debian インストーラ (D-I) のバージョンとソースを指定 (カスタムイメージを含む) +- カスタムバージョンの Debian インストーラコンポーネント (udebs) を含める + +Using easy-build.sh is somewhat simpler than calling make directly or even +than using build.sh as it splits the complex configuration of debian-cd +into three levels: +easy-build.sh を使用すると、make を直接呼び出すよりも、あるいは build.sh を使用するよりも、debian-cd の複雑な設定を 3 つのレベルに分割するので、いくらか簡単になります： +1) CONF.sh: basic configuration such as paths +2) easy-build.sh: characteristicts of the CD/DVD set, for example: + - Debian release + - D-I version and source of D-I images + - number of CDs or DVDs to generate +3) command line parameters: + - type of image (businesscard, netinst, full CD or DVD + - which architecture(s) + - which desktop to install +1) CONF.sh: パスなどの基本設定 +2) easy-build.sh: CD/DVDセットの特徴： + - Debianリリース + - D-I のバージョンと D-I イメージのソース + - 生成する CD/DVD の枚数 +3) コマンドラインパラメータ + - イメージの種類 (ビジネスカード、netinst、フル CD または DVD) + - どのアーキテクチャか + - インストールするデスクトップ + +easy-build.sh also ensures that "task files" are automatically updated as +needed. If custom packages are included it can automatically generate a +Packages file for the local repository: just copy the packages to the +correct location and let easy-build.sh do the rest. +easy-build.shは、必要に応じて "タスクファイル "が自動的に更新されることも保証します。カスタムパッケージが含まれる場合、ローカルリポジトリ用のPackagesファイルを自動的に生成することができます： パッケージを正しい場所にコピーし、後はeasy-build.shに任せてください。 + +Types of images & task definitions +---------------------------------- +easy-build.sh can be used to create four types of images: +easy-build.shは4種類のイメージを作成するために使用します： +- businesscard CD: only contains Debian Installer; any packages neede for + the installed system are retrieved from a mirror during the installation +- netinst CD: contains Debian Installer and all packages needed to install a + Debian "base system" (packages with priority important or higher) +- full CD: same as netinst CD, but filled to capacity with additional + packages based on "task" definitions; image size is 680MB +- DVD: same as full CD, but with an image size of 4.7GB +- businesscard CD: Debian インストーラのみを収録。インストールされるシステムに必要なパッケージは、インストール中にミラーから取得されます。 +- netinst CD: Debian インストーラと、Debian の「基本システム」のインストールに必要なパッケージ (優先度 important 以上のパッケージ) がすべて入っています。 +- full CD: netinst CD と同じですが、「タスク」定義に基づく追加パッケージで容量いっぱいです；イメージサイズは 680MB です。 +- DVD: フル CD と同じですが、イメージサイズは 4.7GB です。 + +The businesscard and netinst CD are always a single image. The size of these +images depends on the architecture. For i386 they are around 40MB and 150MB +respectively. +businesscard と netinst CD は常に単一のイメージです。これらのイメージのサイズはアーキテクチャに依存します。i386の場合、約40MBから150MBです。 + +The full CD and DVD are sets of images, but the set can be limited to any +number. The first image of the set always includes Debian Installer and +packages needed for the base system. After that the first and following +images are filled up to capacity with packages in the following order: +full CD と DVD はイメージのセットですが、セットは任意の数に制限できます。セットの最初のイメージには、常に Debian インストーラと基本システムに必要なパッケージが含まれています。その後、最初のイメージとそれに続くイメージは、以下の順番でパッケージでいっぱいになります： +- "essential" packages from tasksel tasks +- "optional" packages from tasksel tasks +- other packages sorted by popularity (popcon score) +- tasksel タスクの "必須" パッケージ +- tasksel タスクからの "オプション" パッケージ +- その他のパッケージの人気順 (popcon スコア) + +The basic order in which packages are included on full CDs and DVDs is +defined in 'tasks//Debian'. The order in which tasksel tasks are +included is defined in 'tasks//task.list*'. +Full CD や DVD に含まれるパッケージの基本的な順番は 'tasks//Debian' で定義されています。tasksel タスクが含まれる順番は 'tasks//task.list*' で定義されています。 + +Current GNOME and KDE desktop environments are so large that only the +packages needed to install one of them can be included on the first full CD. +Therefore debian-cd supports creating a CD or DVD set targeted at a specific +desktop environment: either GNOME, or KDE, or Xfce. +The default 'task.list' is targeted at the GNOME desktop environment. +現在の GNOME や KDE デスクトップ環境は非常に大きく、インストー ルするのに必要などれか一つのパッケージしか、最初の full CD には含めることができません。そのため debian-cd は、特定のデスクトップ環境 (GNOME、KDE、Xfce のいずれか) を対象とした CD や DVD セットの作成をサポートしています。デフォルトの「task.list」は GNOME デスクトップ環境を対象としています。 + +It is possible to customize the debian-cd task definitions and even to +customize tasksel, but that falls outside the scope of this document. +debian-cd のタスク定義をカスタマイズすることは可能ですし、tasksel をカスタマイズすることもできますが、それはこの文書の範囲外です。 + +CREATING A MIRROR OF THE ARCHIVE +================================ +debian-cd requires you to have a local mirror of the Debian archive, +normally on the same machine where you run debian-cd. There are lots of +methods to create a (partial) local archive. +debian-cd は、通常 debian-cd を実行するのと同じマシン上に、Debian アーカイブのローカルミラーを用意する必要があります。(部分的な) ローカルアーカイブを作成する方法はたくさんあります。 + +Make sure the following are included in your local archive: +以下がローカルアーカイブに含まれていることを確認してください： +- ./dists//main/debian-installer/binary-/ + contains Debian Installer components (udebs) +- ./doc/ +- ./tools/ +and optionally: +そしてオプションとして： +- ./dists//main/installer-/ + contains Debian Installer images (official releases) + +One method is to use debmirror. An example script for creating a full or +partial local mirror using debmirror suitable for use with debian-cd can be +found at: http://alioth.debian.org/~fjp/debmirror/. +一つの方法は debmirror を使用することです。debian-cd での使用に適した、debmirror を使用して完全または部分的なローカルミラーを作成するスクリプトの例は、http://alioth.debian.org/~fjp/debmirror/ にあります。 + +BASIC CONFIGURATION +=================== +Most of the variables in CONF.sh can be left at their default values. Some +just because their default value should be OK for most purposes, some +because their value is set by easy-build.sh itself. +CONF.shの変数のほとんどはデフォルト値のままで構いません。デフォルト値で大抵の目的には問題ないからというだけの理由もあれば、easy-build.sh自身によって設定されるからという理由もあります。 + +The following variables that define paths *must* be set in CONF.sh: +パスを定義する以下の変数は、CONF.shで設定する必要があります： +- MIRROR +- TDIR +- OUT +- APTTMP + +You may also want to change the following variables: +また、以下の変数を変更することもできます： +- CONTRIB: comment out if you only want to include packages from main + mainのパッケージのみを含める場合は、コメントアウトしてください。 +- IMAGESUMS: comment out to skip creating checksums for images + コメントアウトして、イメージのチェックサムの作成を行わないようにする。 +- OMIT_MANUAL +- OMIT_RELEASE_NOTES / RELEASE_NOTES_LOCATION + +Note that if you want to vary the value of a variable for differbent builds +you can also "add" it in easy-build.sh and set it there. +もし異なるビルドのために変数の値を変えたい場合は、easy-build.shで "add" して設定することもできます。 + +BUILDING IMAGES +=============== +After the basic configuration has been done, there are still a few variables +that need to be checked in easy-build.sh itself: +基本的なコンフィギュレーションが行われた後、easy-build.sh自体でチェックする必要のある変数がまだいくつかあります： +- CODENAME: set to the codename (e.g. etch, lenny, sid) of the Debian release + for which you want to build CD/DVD images +- DI_CODENAME: set to the codename of Debian release from which D-I + *components* (udebs) should be taken; normally same value as CODENAME +- DI_DIST/DI_WWW_HOME/DI_DIR: location from where D-I *images* should be + taken; value must "match" the specified DI_CODENAME +- MAX_CDS, MAX_DVDS: only used when building full CD or DVD images +- CODENAME: CD/DVD イメージをビルドしたい Debian リリースのコードネーム (例: etch、lenny、sid) を設定します。 +- DI_CODENAME: D-I *コンポーネント* (udebs) を取得する Debian リリースのコードネームに設定します。 +- DI_DIST/DI_WWW_HOME/DI_DIR: D-I *イメージを取得する場所。 +- MAX_CDS、MAX_DVDS：完全なCDまたはDVDイメージを構築する場合にのみ使用されます。 + +D-I images and components +------------------------- +It is essential that D-I images and components used to build the CD match. +For example, the kernel version included in the D-I image must be the same +as the kernel version of the kernel module udebs copied to the CD. +D-IイメージとCDをビルドするために使用されるコンポーネントが一致していることが不可欠です。例えば、D-Iイメージに含まれるカーネルバージョンは、CDにコピーされたカーネルモジュールudebsのカーネルバージョンと同じでなければなりません。 + +The easy-build.sh script offers four mutually exclusive options to specify +the source of D-I images. In theory more are possible, but the included +options should cover most use cases. +Make sure you have only one of the four options uncommented! And don't let +yourself be confused by the fact that the four options use different +variables. +easy-build.shスクリプトには、D-Iイメージのソースを指定するための4つの互いに排他的なオプションが用意されています。理論的にはもっと多くのオプションが可能ですが、使用されるオプションでほとんどの使用ケースをカバーできるはずです。4つのオプションのうち1つだけがコメントされていないことを確認してほしい！また、4つのオプションが異なる変数を使用していることに惑わされないでください。 + +If you keep to the following basic rules you should be OK. +1) If DI_CODENAME is a real Debian release (e.g. etch or lenny, but not sid) + you should normally use the 1st or 2nd option. Use the 1st option if your + local mirror includes D-I images, else use the the 2nd option. +2) If you use daily built D-I images (3rd option), DI_CODENAME should be set + to "sid". +3) If you use custom images (4th option), DI_CODENAME should match the branch + of the your D-I SVN checkout and build environment; further explanation of + this is outside the scope of this document. +以下の基本的なルールを守れば問題ありません。 +1) DI_CODENAME が本物の Debian リリース (例えば etch や lenny で、sid ではない) の場合、通常は 1 番目か 2 番目のオプションを使用されるべきです。ローカルミラーに D-I イメージが含まれている場合は 1 番目のオプションを使用し、そうでない場合は 2 番目のオプションを使用してください。 +2) 毎日ビルドされるD-Iイメージを使用する場合（3番目のオプション）、DI_CODENAMEを "sid "に設定します。 +3) カスタムイメージを使用する場合（4番目のオプション）、DI_CODENAMEはD-IのSVNチェックアウトとビルド環境のブランチと一致させる必要があります。 + +Examples +-------- +Below are some basic examples how to run easy-build.sh. Examples for some +more advanced usages will be given in later sections. +以下はeasy-build.shの基本的な実行例です。より高度な使い方の例は後のセクションで説明します。 + +1) Build a lenny netinst CD image for i386 +- set CODENAME and DI_CODENAME to "lenny" +- select appropriate source for D-I images (1st or 2nd option) +- run './easy-build.sh NETINST' +1) i386 用の lenny netinst CD イメージをビルドします。 +- CODENAMEとDI_CODENAMEを "lenny "に設定します。 +- D-Iイメージの適切なソースを選択します（1番目または2番目のオプション）。 +- ./easy-build.sh NETINST' を実行します。 + +2) Build the first three CD images for amd64 with KDE as desktop environment +- set MAX_CDS to "3" +- run './easy-build.sh -d kde CD amd64' +2) KDEをデスクトップ環境とするamd64用の最初の3つのCDイメージをビルドします。 +- MAX_CDSを "3 "に設定します。 +- ./easy-build.sh -d kde CD amd64' を実行します。 + +3) Build the full set of DVD images for sparc +- comment out MAX_DVDS +- run './easy-build.sh DVD sparc' +3) sparc用DVDイメージのフルセットを構築します。 +- MAX_DVDSをコメントアウトします。 +- ./easy-build.sh DVD sparc' を実行します。 + +4) Build an i386 netinst to install testing using daily built D-I images +- set CODENAME to the codename for the current testing release +- set DI_CODENAME to "sid" +- select the 3rd option as source for D-I images +- run './easy-build.sh NETINST' +4) i386 netinstをビルドし、毎日ビルドされるD-Iイメージを使用してテストのインストールを行います。 +- CODENAMEを現在のテスト・リリースのコードネームに設定します。 +- DI_CODENAMEを "sid "に設定します。 +- D-Iイメージのソースとして3番目のオプションを選択します。 +- ./easy-build.sh NETINST' を実行します。 + +BUILDING MULTI-ARCH IMAGES +========================== +Multi-arch images are CDs or DVDs that can be used to install more than one +architecture. However, architectures cannot be randomly combined. The main +limitations for combining architectures are: +マルチアーキテクチャイメージとは、複数のアーキテクチャをインストールするために使用されるCDやDVDのことです。ただし、アーキテクチャをランダムに組み合わせることはできません。アーキテクチャを組み合わせるための主な制限は以下のとおりです： +- boot loader files and configuration cannot conflict +- image size +- ブートローダーファイルとコンフィギュレーションは競合できません。 +- イメージサイズ + +The following architectures can safely be combined on a single image: +以下のアーキテクチャは、1つのイメージ上で安全に組み合わせることができます： +- i386, amd64 and powerpc +- alpha, hppa and ia64 + +When you combine two or three architectures on a single 680MB CD there +remains very little space after Debian Installer and base system packages +have been included. For that reason multi-arch CDs are normally created as +a netinst image. For example: +2 つまたは 3 つのアーキテクチャを 680MB の CD 1 枚にまとめる場合、Debian インストーラと基本システムパッケージが含まれた後の容量はほとんどありません。そのため、マルチアーキテクチャ CD は通常 netinst イメージとして作成されます。例えば： +$ ./easy-build.sh NETINST i386 amd64 powerpc + +A DVD has a lot more space and can easily include packages needed to install +a desktop environment. For example: +DVDは容量が多く、デスクトップ環境のインストールに必要なパッケージを簡単に含めることができます。例えば： +$ ./easy-build.sh DVD -d kde i386 amd64 + +It is even possible to include source packages on a DVD, which makes it +suitable to hand out at trade shows. For example: +$ ./easy-build.sh DVD i386 amd64 source + +INCLUDING CUSTOM PACKAGES, D-I COMPONENTS and D-I IMAGES +======================================================== +easy-build.sh makes it relatively simple to include custom packages, both +regular packages (debs) and debian-installer components (udebs), in CD +images. The main rule to keep in mind is that if the package also exists +in the official archive, the version number of your custom package must +be higher than the one of the official package. +easy-build.sh を使うと、通常のパッケージ (debs) と debian-installer コンポーネント (udebs) の両方のカスタムパッケージを、比較的簡単に CD イメージに含めることができます。注意すべき主なルールは、そのパッケージが公式アーカイブにも存在する 場合、カスタムパッケージのバージョン番号は公式パッケージのものより高くなければならないということです。 + +Besides custom debian-installer components (udebs), you can also use custom +or locally built debian-installer images (kernel, initrd and related files). +カスタム debian-installer コンポーネント (udebs) の他に、カスタムまたはローカルでビルドした debian-installer イメージ (kernel、initrd、関連ファイル) を使用することもできます。 + +You should always ensure that udebs included on a CD match the udebs used +when building the debian-installer image you include. For example kernel +versions need to match, but also versioned dependensies between udebs +(and note that not all dependencies between udebs are declared explicitly). +And two udebs from the same source package should in principle have the +same version even if one is included in the initrd and the other is loaded +from the CD during the installation. +CD に収録されている udebs が、収録している debian-installer イメージをビルドする際に使用される udebs と一致していることを常に確認すべきです。例えばカーネルのバージョンは一致させる必要がありますが、udebs 間のバージョン依存関係も一致させる必要があります (そして、udebs 間の依存関係はすべて明示的に宣言されているわけではないことに注意してください)。また、同じソースパッケージからの 2 つの udebs は、たとえ一方が initrd に含まれ、もう一方がインストール中に CD から読み込まれたとしても、原則として同じバージョンであるべきです。 + +Whether custom debs and udebs are used is determined by the environment +variable LOCAL. Whether custom D-I images are used is determined by +selecting the correct source from them, in most cases that will be by +setting DI_DIR (see comments in easy-build.sh). Both variables can be set +in easy-build.sh. +カスタムdebsとudebsが使用されるかどうかは、環境変数LOCALによって決定されます。カスタムD-Iイメージが使用されるかどうかは、それらから正しいソースを選択することによって決定され、ほとんどの場合、DI_DIRを設定することによって決定されます（easy-build.shのコメントを参照）。両方の変数はeasy-build.shで設定することができます。 + +Using custom packages +--------------------- +The repository for the custom packages has the same basic structure as an +official mirror. The main difference is the category: instead of "main" +(or "contrib" or "non-free") this has to be "local". You should also make +sure to use the release codename and not the suite. +カスタムパッケージのリポジトリは、公式ミラーと同じ基本構造を持っています。主な違いはカテゴリです。"main"（または "contrib "や "non-free"）ではなく、"local "でなければなりません。また、スイートではなくリリースのコードネームを使用するようにしてください。 + +So you get for example: +.../dists/lenny/local/binary-amd64/ +.../dists/lenny/local/binary-i386/ +.../dists/lenny/local/debian-installer/binary-amd64/ +.../dists/lenny/local/debian-installer/binary-i386/ +.../dists/sid/local/binary-amd64/ +.../dists/sid/local/binary-i386/ +.../dists/sid/local/debian-installer/binary-amd64/ +.../dists/sid/local/debian-installer/binary-i386/ + +Note that debs will be taken from 'dists/$CODENAME/...' while udebs will be +taken from 'dists/$DI_CODENAME/...'. So if CODENAME and DI_CODENAME have +different values (e.g. when taking debs from testing but using D-I based on +unstable), you will need to place your custom debs and udebs under different +codenames. +debs は 'dists/$CODENAME/...' から取得されるのに対し、udebs は 'dists/$DI_CODENAME/...' から取得されることに注意してください。そのため、CODENAME と DI_CODENAME が異なる値である場合 (例えば、debs を testing から取得し、D-I を unstable ベースで使用する場合など)、カスタム debs と udebs を異なるコードネームで配置する必要があります。 + +The local category does not need to have a Release file, but each +'binary-' directory must have a Packages file. +ローカルカテゴリーにはReleaseファイルは必要ありませんが、各'binary-'ディレクトリにはPackagesファイルが必要です。 + +It is possible to have the packages themselves in a pool directory, but it +is probably easier to just place them under the 'binary-' directories. +You can group packages in subdirectories. +パッケージそのものをプールディレクトリに置くことも可能ですが、「binary-」 ディレクトリの下に置く方が簡単でしょう。パッケージはサブディレクトリにまとめることができます。 + +By default debian-cd will look for the "local" category in the same place +as the official mirror (as defined by the envvar MIRROR), but in most cases +it will be simpler to specify an alternative location by setting the +environment variable LOCALDEBS in your CONF.sh. In that case you can also +let easy-build.sh take care of generating an updated Packages.gz file for +each source that is used in a build by setting the envvar UPDATE_LOCAL in +easy-build.sh (see tools/Packages-gen). +デフォルトでは、debian-cd は公式ミラー (envvar MIRROR で定義) と同じ場所にある "local" カテゴリを探しますが、ほとんどの場合、CONF.sh で環境変数 LOCALDEBS を設定して別の場所を指定する方が簡単でしょう。その場合、easy-build.shでenvvar UPDATE_LOCALを設定することで、ビルドで使用される各ソースに対して更新されたPackages.gzファイルの生成をeasy-build.shに任せることもできます（tools/Packages-genを参照）。 + +Example, assuming we are building for and i386 CD for lenny: +Lenny 用の i386 CD をビルドする場合の例： +1) in CONF.sh, set for example: + export MIRROR=/srv/mirror/debian + export LOCALDEBS=/srv/mirror/custom +2) create the following directories: + /srv/mirror/custom/dists/lenny/local/binary-i386 + /srv/mirror/custom/dists/lenny/local/debian-installer/binary-i386 +3) copy your custom debs to the first directory +4) copy your custom udebs to the second directory +5) in easy-build.sh, set: + export LOCAL=1 + UPDATE_LOCAL=1 + +Note that debian-cd will fail if you set LOCAL but the "local" directory for +a codename/arch/section that is referenced in a build does not exist. +You will need to create the 'dists//local' directories, but if +UPDATE_LOCAL is set, easy-build.sh will automatically create any missing +'binary-' subdirectories and (empty) Packages.gz files. +LOCAL を設定しても、ビルドで参照されるコードネーム/arch/セクションの 「ローカル」ディレクトリが存在しない場合、debian-cd は失敗することに注意してください。dists//local' ディレクトリを作成する必要がありますが、UPDATE_LOCAL が設定されていれば、easy-build.sh は自動的に欠落している 'binary-' サブディレクトリと (空の) Packages.gz ファイルを作成します。 + +Using custom debian-installer images +------------------------------------ +Note that the build target used and the way images are organized under the +build/dest directory by the debian-installer build system varies per +architecture. The example below should work for i386 and amd64, but may need +to be adjusted for other architectures. +使用されるビルドターゲットや、debian-installer ビルドシステムによる build/dest ディレクトリ配下のイメージの整理方法は、アーキテクチャごとに異なることに注意してください。以下の例は i386 と amd64 で動作するはずですが、他のアーキテクチャでは調整が必要かもしれません。 + +Example: +1) create a directory, for example: + /srv/mirror/custom/images/i386/ +2) build the d-i images (in the installer/build directory) using: + $ make reallyclean; fakeroot make build_cdrom_isolinux +3) copy the images using: + $ cp -r dest/cdrom /srv/mirror/custom/images/i386/ +4) in easy-build.sh, set: + export DI_DIR="/srv/mirror/custom/images/%ARCH%" + +'%ARCH%' will be automatically expanded to the correct architecture whe +debian-cd is run. +'%ARCH%' は debian-cd の実行時に正しいアーキテクチャに自動的に展開されます。 + diff --git a/debian-cd/README.txt b/debian-cd/README.txt new file mode 100644 index 0000000..4450849 --- /dev/null +++ b/debian-cd/README.txt @@ -0,0 +1,409 @@ +debian-cd +========= + +Copyright 1999-2001 Raphaël Hertzog and others, +2004-2019 Steve McIntyre +This set of tools is licensed under the General Public License version +2 or any later version. You can find it in +/usr/share/common-licenses/GPL on a Debian GNU system. + +Some of the ideas here (a loooong time ago) came from Steve McIntyre's +slink_cd script. + +Thanks also to all the contributors on the debian-cd mailing list. + +What is needed? +=============== +Software: +- the apt-get (>= 0.3.11.1) tool +- perl (>= 5.004) +- bash (or another POSIX shell) +- make +- cpp +- mkisofs/genisoimage +- the perl Digest::MD5 module +- the perl Compress::Zlib module +- lynx (for text version of README.html) and todos from sysutils + to convert docs to DOS format (although you can rip that out, too) +- if you want to generate jigdo files: jigdo-file (see below) +Other: +- apt-utils (for apt-ftparchive) +- lots of free space on your disks +- a Debian mirror, on a partition where you can write. + If you can't write on it then you may try to use a symlink farm, + but it's not the recommended way to build Debian CDs. + + + ------------------------------- + - GENERATING DEBIAN CD IMAGES - + ------------------------------- + + +For the people that don't have time, here's the quick explanation +時間がない人のために、簡単に説明しましょう。 +================================================================= + +Edit the CONF.sh and change the PATHs for the mirror and so on. +CONF.shを編集し、ミラーのPATHなどを変更します。 +$ sensible-editor CONF.sh +$ . CONF.sh +$ make distclean +$ make status +$ make official_images + +However, you really should consider reading further for more information. +You can also take a look at build.sh and build_all.sh for an automated +way of building CD images. +しかし、より詳細な情報については、さらに読むことを本当に検討すべきです。 +build.shとbuild_all.shは、CDイメージの自動ビルドのためのものです。 + +The script easy-build.sh offers the easiest way to build a specific image +or set of images, but is still very flexible and powerful. It is the +recommended tool for building test images and for people new to debian-cd. +See the file README.easy-build for further info. +easy-build.sh スクリプトは、特定のイメージやイメージ群を構築する最も 簡単な方法を提供しますが、非常に柔軟で強力です。テストイメージのビルドや、 debian-cd を初めて使う人にお勧めのツールです。 +詳細は README.easy-build をご覧ください。 + +How to build a CD set - step by step +==================================== + +If you haven't already, change to the /usr/share/debian-cd/ directory +(or, alternatively, set the variable BASEDIR in CONF.sh to point +there). +まだであれば、/usr/share/debian-cd/ディレクトリに移動してください（あるいは、CONF.shの変数BASEDIRがそこを指すように設定してください）。 + +The process of building a CD is composed of the following steps: +CDを作るプロセスは次のようなステップで構成されます： + +- first configure what is needed in CONF.sh and source it in your shell: +- まずCONF.shで必要なものを設定し、シェルでそれをソースにします：CONF.shで必要なものを設定し、シェルでそれをソースにします： + + $ . CONF.sh + + The exported environment variables will be used by all the + tools involved here (Makefiles, perl scripts, shell scripts). + エクスポートされた環境変数は、ここに関係するすべてのツール（Makefile、perlスクリプト、シェルスクリプト）で使用されます。 + + If you want to build CD images for more than one arch, you will + have to build them one after the other (you may use a shell + script for this). + 複数のアーキ用のCDイメージをビルドしたい場合は、1つずつビルドする必要があります（シェルスクリプトを使用することもできます）。 + + Note that the temporary dir must be on the same device as the + mirror because debian-cd uses hardlinks for generating an image + tree. If you can't do this, you'll have to use a symlink farm. + The symlink farm is explained at the end of this README. + debian-cd はイメージツリーの生成にハードリンクを使用されるため、 一時ディレクトリはミラーと同じデバイス上になければならないことに注意してください。これができない場合は、シンボリックリンクファームを使用する必要があります。シンボリックリンクファームについては、この README の最後で説明しています。 + + Keep in mind that the environment variables will stay in the + environment after your debian-cd run, and may interfere with + other program using the same variables (e.g. kernel-package). + So if you want to be 100% safe, run debian-cd in a + separate shell that you can leave after you're done. + 環境変数は debian-cd の実行後も環境に残り、同じ変数 (例えば kernel-package) を使用している他のプログラムに干渉する可能性があることに留意してください。そのため、100% 安全を期すなら、debian-cd を別のシェルで実行し、終了後にそのシェルから離れるようにしてください。 + +- then we clean everything that may still be there from previous runs: +- その後、以前の走行から残っている可能性のあるものをすべてきれいにします： + + $ make distclean + +- then we initialize the temporary directory used for the build: +- 次に、ビルドに使用される一時ディレクトリを初期化します： + + $ make status + + If this has failed then this will be automatically launched: + これが失敗した場合は、自動的に起動されます： + + $ make correctstatus + + Note however that "make status" should never fail if it is + used for building a CD set for the stable release... + ただし、"make status "が安定版リリースのCDセット構築に使用されるのであれば、失敗することはないはずです...。 + +- now you can decide what you want on your CDs +- CDに何を入れたいか、自分で決められるようになりました。 + + Note that task files are always taken from the subdirectory in ./tasks/ + that matches the CODENAME environment variable. At the beginning of a + build these "static" task files are copied to the working directory. + During the build some additional task files - that are referenced from + the static task files - are generated automatically using scripts from + the ./tools directory. + タスクファイルは常に環境変数CODENAMEにマッチする ./tasks/のサブディレクトリから取得されることに注意してください。ビルドの開始時に、これらの「静的」タスクファイルは作業ディレクトリにコピーされます。ビルド中に、./toolsディレクトリのスクリプトを使用して、静的タスクファイルから参照されるいくつかの追加タスクファイルが自動的に生成されます。 + + Examples: + その例： + + $ make packagelists TASK=Debian-generic COMPLETE=1 + + or + または + + $ make packagelists TASK=Debian-kde COMPLETE=0 + + or + または + + $ export NONFREE=1; make packagelists TASK=your-task-here COMPLETE=1 + + or for something like an official image for the USA (without non-free): + または、アメリカの公式イメージのようなもの（ノンフリーは除く）： + + $ make packagelists COMPLETE=1 + + .... take a look at the file tasks/* to see the options you can have :) + .... tasks/*というファイルを見て、オプションを見てみましょう。 :) + + You can change the behaviour of this command with the following + variables: + - if NONFREE is set, then packages from non-free will be allowed + (NONFREE must be exported to all sub-shells) + - if EXTRANONFREE is set, then non-free packages will be included + on an extra CD (the last CD in fact). Don't use NONFREE and + EXTRANONFREE at the same time! + (EXTRANONFREE must be exported to all sub-shells) + - if COMPLETE is set, all packages that are not listed in the + selected task file will be included at the end + - setting INSTALLER_CD will use an appropriate task file for + building small CDs (businesscard and netinst) + このコマンドの動作は、以下の変数で変更できます： + - NONFREE が設定されている場合、non-free からのパッケージが許可されます (NONFREE はすべてのサブシェルにエクスポートされなければなりません)。 + - EXTRANONFREE が設定されている場合、non-free のパッケージは追加 CD (実際には最後の CD) に含まれます。NONFREEとEXTRANONFREEを同時に使用しないでください！ (EXTRANONFREEはすべてのサブシェルにエクスポートされなければなりません) + - COMPLETEが設定されている場合、選択されたタスクファイルにリストされていないすべてのパッケージが最後に含まれます。 + - INSTALLER_CDを設定すると、スモールCD（businesscardとnetinst）のビルドに適切なタスクファイルが使用されます。 + +- now, we'll start making temporary trees: +- では、仮のツリーを作り始めます： + + $ make image-trees + + This will first work sort the list of packages for each architecture + into order so that standard, required, important and base packages + are placed first, then other packages will be added in the order + given modulo dependency ordering. Once the sorted list is created, + the different architecture lists will be merged (if more than one + architecture is selected). + これはまず、各アーキテクチャのパッケージ一覧を、標準、必須、重要、基本パッケ ージが最初に来るようにソートします。ソートされたリストが作成されると、異なるアーキテクチャのリストは (複数のアーキテクチャが選択されている場合) マージされます。 + + Then the code will start laying out temporary directory trees for + the CDs. In order, this includes the following steps: + それから、コードはCDのための一時的なディレクトリツリーを作り始めます。順を追って説明すると、次のような手順です： + + - Creating an empty directory layout + - Generating an image label and volume ID and other metadata such as + debian-installer information files + - Add documentation and installation/upgrade tools + - Add Release files and other archive metadata + - Make the image bootable for the selected architecture(s) + - Start generating the md5sum.txt file + - 空のディレクトリレイアウトの作成 + - イメージラベルとボリューム ID、および debian-installer 情報ファイルなどのメタデータの生成 + - ドキュメントやインストール/アップグレードツールの追加 + - リリースファイルやその他のアーカイブメタデータを追加 + - 選択したアーキテクチャでイメージを起動可能にする + - md5sum.txt ファイルの生成を開始 + + If you want to use boot-floppies built by yourself you can add + a parameter BOOTDISKS= which specifies the directory where + they are. Note that $BOOTDISKS/current must be a symlink to the + real directory and it must follow the same setup as the FTP + mirror. Your boot-floppies must also be on the same partition as + your mirror and temporary dir (hardlinks are used here too). + 自分でビルドしたブートフロッピーを使用したい場合は、BOOTDISKS= というパラメータを追加して、ブートフロッピーがあるディレクトリを指定してください。BOOTDISKS/currentは実際のディレクトリへのシンボリックリンクでなければならず、FTPミラーと同じセットアップに従わなければならないことに注意してください。ブートフロッピーもミラーや一時ディレクトリと同じパーティションになければなりません (ここでもハードリンクが使用されます)。 + + Once the disc tree has all of this start data, we start filling the + directory trees with packages from the sorted list. The size of the + image to be created is set using DISKTYPE in CONF.sh; if the + standard sizes do not match what you're after, use DISKTYPE=CUSTOM + and specify your own size using CUSTOMSIZE. The algorithm is simple + for adding packages: + ディスクツリーにこの開始データがすべて揃ったら、ソートされたリストからディレクトリツリーにパッケージを詰め始めます。作成するイメージのサイズは、CONF.sh の DISKTYPE で設定します。標準のサイズが希望に合わない場合は、DISKTYPE=CUSTOM を使用し、CUSTOMSIZE でサイズを指定してください。パッケージを追加するアルゴリズムは簡単です： + + - link the package into the temporary disc tree + - append the metadata to the appropriate Packages or Sources file + - add md5sum information for the added file(s) to the md5sum.txt file + - パッケージを一時ディスクツリーにリンクする + - メタデータを適切な Packages または Sources ファイルに追加する + - 追加したファイルのmd5sum情報をmd5sum.txtファイルに追加する + + This continues until the temporary tree grows one package *too + large* for the selected image size. At that point, we roll back the + last set of changes associated with that package. Then: + これは、テンポラリツリーが、選択したイメージ容量に対して *大きすぎる* パッケージに拡張されるまで続きます。その時点で、そのパッケージに関連する最後の変更セットをロールバックします。そして： + + - check if the disc contains all the packages needed to install a base system + - finish off the Release file, using the checksums of the + Packages/Sources files we generated + - finish off the md5sum.txt file + - ディスクにベースシステムのインストールに必要なパッケージがすべて含まれているかチェックする + - 生成したPackages/Sourcesファイルのチェックサムを使用して、Releaseファイルを完成させる + - md5sum.txtファイルを完成させる + + Next, we continue to the next disc tree, using the same process: + start it, copy packages in until they overflow, roll back and + finish. And repeat. Each time a package is found to be too large to + fit inside an image, it will be kept back and will (obviously) be + the first package placed into the next disc tree. + 続いて次のディスクツリーに進み、同じプロセスを使用します。ディスクツリーを起動し、パッケージがあふれるまでコピーし、ロールバックして終了します。これを繰り返します。パッケージが大きすぎてイメージ内に収まらないことが判明するたびに、そのパッケージは戻され、（明らかに）次のディスクツリーに置かれる最初のパッケージになります。 + +- now we can create the images: +- これでイメージを作ることができます： + + $ make images + + If you don't have enough space for all images, you can generate + only one image (of the second CD for example) with: + すべてのイメージを保存するのに十分なスペースがない場合は、（たとえば2枚目のCDの）イメージを1枚だけ生成することができます： + + $ make image CD=2 + + Note: here we use "make images", but you could as well use + "make official_images" since the latter is the same as the former + with some dependencies on targets that you already launched + (make bootable packages sources). + 注：ここでは "make images"を使用していますが、"make official_images"を使用することもできます。後者は前者と同じで、すでに起動したターゲットに依存する部分があるからです（make bootable packages sources）。 + +- if you want to generate checkum files with the checksums of the + images you can do it with: +- もし、イメージのチェックサムでチェックサムファイルを生成したいのであれば、これでできます： + + $ make imagesums + +Official images +=============== + +If you use make official_images you're building CD images that have +the same properties than official CD images but they still doesn't +have the name of "Official Images". The name of the images is given +by setting the OFFICIAL and DEBVERSION environment variable (check +CONF.sh). +make official_imagesを使用されると、公式CDイメージと同じプロパティを持つCDイメージがビルドされますが、まだ「公式イメージ」という名前はありません。イメージの名前は環境変数OFFICIALとDEBVERSIONを設定することで与えられます（CONF.shを確認してください）。 + +Please never ever use the "Official" name for a CD image that you +built yourself. The only images that can be called "Official" are the +ones built by Debian itself and which are provided on Debian's +servers. +自分でビルドした CD イメージには、決して「公式」という名前を使わないでください。「公式」と呼べるイメージは、Debian 自身がビルドし、Debian のサーバで提供されているものだけです。 + +The default configuration shipped with this package will automatically +name the images "Unofficial". CD will work exactly in the same way +with all Debian tools, only the label is different. That means you +can use build.sh and build_all.sh to build your "Unofficial" images +without modifying anything. +本パッケージに同梱されているデフォルトの設定では、イメージに自動的に 「Unofficial」という名前が付けられます。CD は、ラベルが異なるだけで、すべての Debian ツールと全く同じように動作します。つまり、build.sh や build_all.sh を使用して、何も変更せずに「非公式」イメージをビルドできます。 + + +Local packages +============== + +If you provide some custom made packages and you want to put them on +Debian CD set you can do it. Simply put your packages in +$MIRROR/dists/$CODENAME/local/binary-$ARCH/
. +The organization of this sub-tree is the same than what you can find +in the main, contrib or non-free part. You may use different section +names if you want. Be sure to create Packages files (and Sources.gz if you +include sources). +もしあなたがカスタムパッケージを提供し、それを Debian CD セットに 組み込みたいのであれば、それは可能です。あなたのパッケージを $MIRROR/dists/$CODENAME/local/binary-$ARCH/
に置くだけです。このサブツリーの構成は、main、contrib、non-free にあるものと同じです。必要であれば、異なるセクション名を使用しても構いません。必ずPackagesファイル(ソースを含む場合はSources.gz)を作成してください。 + +You can also put your local packages under $MIRROR/pool/local (just a new +facility for people who don't want packages under dists/). To include local +packages, the LOCAL environment variable must be set to "1" while building +the CDs. +ローカルパッケージを $MIRROR/pool/local 配下に置くこともできます (dists/ 配下にパッケージを置きたくない人のための新しい機能です)。ローカルパッケージを含めるには、CD をビルドするときに環境変数 LOCAL を "1" に設定しなければなりません。 + +You can also set the LOCALDEBS environment variable, and it will be used +instead of MIRROR when looking for local packages. +LOCALDEBS環境変数を設定すると、ローカルパッケージを探すときにMIRRORの代わりに使用されます。 + + +Additional targets +================== + +Jigdo +----- +You may also want to make the CD images available in jigdo format. +Jigsaw Download, the successor to the Pseudo-Image Kit. +See https://www.debian.org/CD/jigdo-cd/ for more information on jigdo. +CDイメージをjigdo形式で利用できるようにすることもできます。 +Jigsaw DownloadはPseudo-Image Kitの後継です。 +jigdoについては https://www.debian.org/CD/jigdo-cd/ 参照。 + +Set the DOJIGDO and related variables in CONF.sh. This is no separate target +for jigdo, merely a modification of the "images" targets. You can choose +only .iso generation (default), only .jigdo generation (for highly reduced +disk usage), or both .iso and .jigdo generation. +CONF.shでDOJIGDOと関連する変数を設定します。これは単に "images"ターゲットを変更するだけで、jigdo用の独立したターゲットではありません。.iso生成のみ（デフォルト）、.jigdo生成のみ（ディスク使用量を大幅に削減）、.isoと.jigdo生成の両方を選択できます。 + +To generate the jigdo files and templates, you need an +appropriately-patched version of mkisofs/genisoimage, as shipped in +Debian Etch. +jigdoファイルとテンプレートを生成するには、Debian Etchに同梱されているmkisofs/genisoimageの適切なパッチが適用されたバージョンが必要です。 + +The checksums files generated by the "imagesums" target will contain +the checksums of all generated images, regardless of the DOJIGDO +setting. If no full iso image is available, the checksums will be +extracted from the .template files. A note in the Makefile shows how +the original file size can be extracted from the .template in a +similar way. +"imagesums"ターゲットが生成するチェックサムファイルには、DOJIGDOの設定に関係なく、生成されたすべてのイメージのチェックサムが含まれます。完全な ISO イメージがない場合、チェックサムは .template ファイルから抽出されます。Makefile の注釈に、同様の方法でオリジナルのファイルサイズを .template から抽出する方法が示されています。 + +About jigdo "fallback servers": +jigdoの「フォールバックサーバー」について： + +jigdo works by downloading individual packages and other files from a +normal Debian mirror, and using them to regenerate a CD/DVD image. +However, the content of Debian mirrors changes over time, files are +added and removed. But jigdo must have access to all files needed for +the image it has to regenerate, even those that have been removed from +the normal Debian mirrors. +jigdo は通常の Debian ミラーから個々のパッケージやその他のファイルを ダウンロードし、それを使用して CD/DVD イメージを再生成することで動作します。 しかし、Debian ミラーの内容は時間とともに変化し、ファイルが追加されたり削除されたりします。しかし、jigdo は再生成するイメージに必要なすべてのファイルにアクセスできなければなりません。 + +A fallback server contains a backup of the Debian FTP space for the +moment the .jigdo files were generated. This backup is made available +under a certain URL which is written to the .jigdo files. jigdo will +*only* revert to the fallback server after an unsuccessful attempt to +retrieve a file from the normal user-selected Debian mirror, so the +bandwidth requirements are modest. +フォールバックサーバには、.jigdo ファイルが生成された時点の Debian FTP 空間のバックアップが含まれています。このバックアップは、.jigdo ファイルに書き込まれた特定の URL で利用できるようになります。jigdo は、ユーザが選択した通常の Debian ミラーからファイルを取得しようとして失敗した場合にのみフォールバックサーバに戻るので、必要な帯域幅はわずかです。 + +A fallback is even necessary for .jigdo files of the stable release, +because some files (typically documentation or boot floppies) can +change at any time. +フォールバックは、安定版リリースの.jigdoファイルにも必要です。というのも、いくつかのファイル（通常はドキュメントやブートフロッピー）はいつでも変更できるからです。 + +debian-cd allows you to automatically create a directory on disc which +is suitable for use as a fallback mirror. It is populated with hard +links to the archive contents. In CONF.sh, simply supply as +JIGDOFALLBACKPATH the name of the directory, and as JIGDOFALLBACKURLS +the URLs under which it will be made available. +debian-cd は、フォールバックミラーとして使用するのに適したディレクトリをディスク上に自動的に作成します。このディレクトリには、アーカイブの内容へのハードリンクが設定されます。CONF.sh では、単に JIGDOFALLBACKPATH としてディレクトリの名前を、JIGDOFALLBACKURLS として利用可能な URL を指定してください。 + +About the hook system +===================== + +A hook script can be executed at different times during the CD build +process to customise your CDs. You can specify the script by setting +the various HOOK variables in CONF.sh; look there for more information +about what hook points are available. +フックスクリプトは、CDのビルドプロセス中に異なるタイミングで実行され、CDをカスタマイズすることができます。CONF.sh で様々な HOOK 変数を設定することで、スクリプトを指定することができます。 + +About the symlink farm +====================== + +If you don't have write access on the disk where you have the mirror +or if for another reason hardlink cannot be used, you can try to +use a symlink farm. Instead of having real files, your temporary tree +will be filled with symlinks that mkhybrid will change into files when +it will build the image. You'll need to use a special options. You +have 2 lines of options in CONF.sh as examples. +ミラーのあるディスクに書き込みアクセスがない場合、あるいは他の理由でハードリンクが使用できない場合は、シンボリックリンクファームを使用してみてください。実際のファイルを持つ代わりに、一時ツリーをシンボリックリンクで満たし、mkhybridがイメージを構築する際にファイルに変更します。特別なオプションを使用する必要があります。例として、CONF.shに2行のオプションがあります。 + +I've never tested the symlink farm ... it may well generate unusable +images. Don't use it for ISO images that will used by many users. +私はシンボリックリンクのファームをテストしたことがありません...使用不可能なイメージを生成する可能性があります。多くのユーザーに使用されるISOイメージには使わないでください。 + +Note that you will also need a patched mkhybrid that does support the +-F option. Have a look here about it : +Fオプションをサポートするmkhybridのパッチも必要です。詳しくはこちらをご覧ください： +https://www.chiark.greenend.org.uk/~stevem/DebianCD/