最初からDebianパッケージを作成する

Debianパッケージをゼロから作成することは、一種の魔法のプロセスです。 「Debianパッケージをゼロから構築する」というリクエストでGoogleを起動すると、多くの結果が得られますが、どれも必要なものにはなりません。 間違いなく、Debianで使用されるコマンドの優れた概要を見つけることができ、十分に深く掘り下げると、基本的なDebianパッケージの作成に役立ついくつかのコマンドを見つけることができますが、何が起こっているのかを説明することはできません。 「ハプニング」とは何かに関する詳細な情報を得ることができます。この投稿では、これについて部分的に触れます。







まず、いくつかの依存関係をインストールすることから始める必要があります。 このチュートリアルはすべてUbuntu 14.04に基づいて作成されていますが、ほとんどのDebianベースのオペレーティングシステムに適しています。 次のコマンドを実行して開始します。

sudo apt-get install build-essential dh-make
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

次に、すべてのコンポーネントを配置するパッケージを作成する必要があります。 この場合、パッケージは「mylittledeb」と呼ばれます。 次のコマンドを使用して、パッケージをインストールします。

 mkdir mylittledeb touch mylittledeb/Makefile touch mylittledeb/hello.c
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

hello.cのコンテンツには、古典的な「Hello、World」が含まれている必要があります。

 #include <stdio.h> int main() { printf(“Hello, World\n”); return 0; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

メイクファイルには次の内容が含まれている必要があります。 Makeファイルに慣れていない人のための情報-コマンドを実行するときにスペースではなく「_」を使用する必要があり、エラーが発生するリスクがあります。 また、バイナリファイルを削除した後、ターゲット要素のクリーニングが||true



に設定されることに注意してください。 将来、作成前にmake clean



実行することにより、指定された不一致およびその他のDebian要素を使用します。

 all: gcc hello.c -o hello clean: rm hello || true
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

この時点で、ユーザーが「Hello、World」を印刷できるDebianパッケージが作成されました。 これは最もおもしろい部分ではありませんが、さらに多くのことがあります。 この時点で、 make



を実行make



とバイナリhello呼び出しが生成され、「Hello、World」のバイナリ出力が実行されるmake



を確認します。 これが起こらなかった場合、それは何かがうまくいかなかったことを意味し、先に進むために修正する必要があります。



最後に、実際にパッケージの作成を開始できます！ Debianパッケージを初期化するには、以前にインストールした便利なdh_make



プログラムを使用します。 以下に示すのと同じ設定で次のコマンドを実行すると、エラーが発生するはずですが、これは計画的なエラーです。 この場合、dh_makeとは何かを理解し、より高度なパッケージを使用する際に後で発生する可能性のある他の問題を解決する方法を理解することが重要です。

 dh_make -p mylittledeb_0.0.1 Type of package: single binary, indep binary, multiple binary, library, kernel module, kernel patch? [s/i/m/l/k/n] s Maintainer name : root Email-Address : root@unknown Date : Sun, 10 Apr 2016 14:38:32 -0400 Package Name : mylittledeb Version : 0.0.1 License : blank Type of Package : Single Hit <enter> to confirm: Could not find mylittledeb_0.0.1.orig.tar.xz Either specify an alternate file to use with -f, or add --createorig to create one.
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

エラーメッセージを受け取りました。 ここで、このエラーに関連するいくつかのことを検討してください。 まず、orig.tar.xzファイルとは何ですか。 次に、なぜ-pフラグが使用されたのですか？ 簡単な質問から始めましょう。 dh_makeは、現在いるディレクトリの名前を調べてパッケージ名とバージョンを確認するため、-pフラグが使用されます。 多くの場合、この方法でディレクトリを呼び出すのは愚かであるため、-pフラグを初めて実行すると、dh_makeはデータを<パッケージ名> _ <バージョン>の形式で送信します。



では、どのようなファイルorig.tar.xzを見つけましょう。 公式文書では、これは単なるソースコードのtarballであり、この場合はディレクトリの現在の状態にすぎないと述べています。 ただし、おそらくこのorig.tar.xzファイルには特別なものがあります。 それでは、作成方法を見てみましょう。 次のコマンドを実行すると、dh-makeのソースコードを分解できます。 mylittledebパッケージでこれを行うと、すべてのファイルをクリアする必要があるため、tmpでこれを行うことができます。

 apt-get source dh_make
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ソースコードが用意できたので、次に何が起こるか見てみましょう。 dh_makeスクリプトを開くと、内部のPerlファイルを見つけることができます。 Vimでorig.tar.xzを検索すると、次の行に進みます。

 system('tar', 'cfJ', “../$package_name\_$version.orig.tar.xz”, “.”);
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これは単なる古いtarアーカイブファイルです。 ただし、すべてがうまくいかない場合に備えて、これらの魔法のDebianスクリプトはすべて作成されていることをある程度理解しておく必要があります。 では、mylittledebフォルダーに戻って、次を実行します。

 dh_make -p mylittledeb_0.0.1 --createorig
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これで、mylittledebフォルダーに次の内容のDEBiANフォルダーが表示されます。

 changelog compat control copyright docs init.d.ex manpage.1.ex manpage.sgml.ex manpage.xml.ex menu.ex mylittledeb.cron.d.ex mylittledeb.default.ex mylittledeb.doc-base.EX postinst.ex postrm.ex preinst.ex prerm.ex README.Debian README.source rules source watch.ex
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

.exおよび.EXファイルはファイルの例です。 それらのほとんどは必要ありません。



changelog-このファイルはパッケージのバージョンを制御し、最後の更新以降に変更された内容も簡単に説明します。 メインファイルは次のようになります。

 mylittledeb (0.0.1–1) unstable; urgency=low * Initial release (Closes: #nnnn) <nnnn -    ITP> — root <root@unknown> Sun, 10 Apr 2016 15:00:11 -0400
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

「mylittledeb」には「0.0.1」という名前が含まれ、これはパッケージのバージョンであり、最後の「1」はDebianのバージョンです。 Debianパッケージが対象となり、さまざまなディストリビューションに移植される不安定なディストリビューションは、このプロセスの外部で行われます。 この場合、これはすべてUbuntu 14.04上に構築されているため、単にtrustyを使用します。 すべてを実行すると、次のようになります。

 mylittledeb (0.0.1–1) trusty; urgency=low * Intial package release — root <root@unknown> Sun, 10 Apr 2016 15:00:11 -0400
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

パッケージに署名する場合は、最後の行にGPGキーに関連付けられた名前を含める必要があります。 ただし、パッケージに署名することはできます。 現時点では、この項目は無視できます。



compatは魔法のファイルであり、常に数字の9を使用する必要があります。これは、見つけることができる唯一の情報です。 なぜ正確に9ですか？ さて、 debhelperパッケージのすべてのツールで使用されます。これにより、Debianファイルの互換性が確保されます。



control-制御ファイルには、「apt-cache show mylittledeb」を実行したときに表示されるパッケージに関する独立した情報が含まれています。 これはすべてDebian wikiで非常によく説明されています 。 パッケージは次のようになります。

 Source: mylittledeb Section: devel Priority: optional Maintainer: root <root@unknown> Build-Depends: debhelper (>= 8.0.0) Standards-Version: 3.9.4 #Vcs-Git: git://git.debian.org/collab-maint/mylittledeb.git #Vcs-Browser: http://git.debian.org/?p=collab-maint/mylittledeb.git;a=summary Package: mylittledeb Architecture: any Depends: ${shlibs:Depends}, ${misc:Depends} Description: An example debian package that says “Hello, World”
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

パッケージのすべての依存関係が含まれているため、依存関係アセンブリを正しく構築する必要があることを理解する必要があります。 プログラムを実行する依存関係のみを含むDepends



に追加しないでください。 ここで重要なのは、{shlibs：Depends}と{misc：Depends}は、dh_shlibdepsコマンドによって呼び出される2つの魔法の行であるということです。 このコマンドは、バイナリのニーズである依存関係を定義するのに役立ちますが、これはすぐにはわかりません。



著作権は最も明白なファイルであり、パッケージを一般に公開することに関心がある場合は、単にこのファイルを含める必要があります。



docs-このファイルには、キットに含まれるすべてのファイルの名前をリストできます。



ルール-パッケージの作成に関するすべての情報を含むDebianルールファイルで、Makefileの特別なバージョンです。 このファイルは、Debianファイルの作成に使用される追加の目標を示しています。 デフォルトでは、これは基本的なコマンドを起動するだけの非常にシンプルなファイルです。 ただし、たとえば、アセンブリの前にディレクトリをクリーンアップする方法など、何かを再定義する必要がある場合は、次のようにする必要があります。

 #!/usr/bin/make -f # -*- makefile -*- # Uncomment this to turn on verbose mode. #export DH_VERBOSE=1 override_dh_auto_clean: rm /tmp/random.file %: dh $@
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

使用可能なすべてのオーバーライドは、このwiki記事と、ルールファイルの詳細な説明にリストされています。 デフォルトでは、すべてのdebhelperツールはこの方法でこのファイルを使用します。たとえば、ディレクトリをクリーンアップする場合は、新しいパッケージを作成する前にこれを行う必要があり、次の「dh clean」コマンドが実行されます。 このコマンドは順番にdh_testdir、dh_auto_clean、dh_cleanを呼び出し、これらはいくつかのperlスクリプトを順番に呼び出します。



現時点ではこのファイルを編集する必要はありませんが、独自のDebianパッケージを作成するときに必要に応じて後で機能を設定できることに注意してください。



ソース/フォーマット-このファイルは非常に単純なようです。 現時点では、そのままにしておくことができます。 これはコンパイル形式であり、以前に作成したアップストリームtarballにパッチを適用する特定の方法であることを知ってください。



* .install-このファイルは自動的に作成されないため、mylittledeb.installというファイルを作成する必要があります。 インストール時に追加されたファイルは、バイナリのインストールに使用されます。 パッケージをインストールするときに、システムにあるファイルまたはディレクトリが使用されます。 「hello world」バイナリがあるため、これをユーザーシステムに配置する必要があります。 次のファイルは、「hello world」バイナリをユーザーディレクトリ/ usr / binに配置します。

 hello /usr/bin
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

.exおよび.EXで終わる残りのファイルには、さまざまなファイルの機能の説明が含まれています。 もちろん、それらを保存する方が良いですが、削除してもひどいことは起こりません。



簡単な部分です。 次のコマンドを実行します。

 dpkg-buildpackage
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

export DH_VERBOSE=1



コメントをexport DH_VERBOSE=1



と、現在実行中のすべてのコマンドを確認できます。 これらすべてのコマンドを再定義できるため、独自のパッケージに問題がある場合は、その原因を特定できます。



上記のコマンドの出力は次のとおりです。

 dpkg-buildpackage: source package mylittledeb dpkg-buildpackage: source version 0.0.1-1 dpkg-buildpackage: source distribution trusty dpkg-buildpackage: source changed by root <root@unknown> dpkg-buildpackage: host architecture amd64 dpkg-source --before-build mylittledeb debian/rules clean dh clean dh_testdir dh_auto_clean make -j1 clean make[1]: Entering directory `/root/mylittledeb' rm hello || true rm: cannot remove 'hello': No such file or directory make[1]: Leaving directory `/root/mylittledeb' dh_clean rm -f debian/mylittledeb.substvars rm -f debian/mylittledeb.*.debhelper rm -rf debian/mylittledeb/ rm -f debian/*.debhelper.log rm -f debian/files find . \( \( -type f -a \ \( -name '#*#' -o -name '.*~' -o -name '*~' -o -name DEADJOE \ -o -name '*.orig' -o -name '*.rej' -o -name '*.bak' \ -o -name '.*.orig' -o -name .*.rej -o -name '.SUMS' \ -o -name TAGS -o \( -path '*/.deps/*' -a -name '*.P' \) \ \) -exec rm -f {} + \) -o \ \( -type d -a -name autom4te.cache -prune -exec rm -rf {} + \) \) rm -f *-stamp dpkg-source -b mylittledeb dpkg-source: info: using source format `3.0 (quilt)' dpkg-source: info: building mylittledeb using existing ./mylittledeb_0.0.1.orig.tar.xz dpkg-source: info: building mylittledeb in mylittledeb_0.0.1-1.debian.tar.gz dpkg-source: info: building mylittledeb in mylittledeb_0.0.1-1.dsc debian/rules build dh build dh_testdir dh_auto_configure dh_auto_build make -j1 make[1]: Entering directory `/root/mylittledeb' gcc hello.c -o hello make[1]: Leaving directory `/root/mylittledeb' dh_auto_test debian/rules binary dh binary dh_testroot dh_prep rm -f debian/mylittledeb.substvars rm -f debian/mylittledeb.*.debhelper rm -rf debian/mylittledeb/ dh_auto_install install -d debian/mylittledeb dh_install install -d debian/mylittledeb//usr/bin cp -a ./hello debian/mylittledeb//usr/bin/ dh_installdocs install -g 0 -o 0 -d debian/mylittledeb/usr/share/doc/mylittledeb chown -R 0:0 debian/mylittledeb/usr/share/doc chmod -R go=rX debian/mylittledeb/usr/share/doc chmod -R u\+rw debian/mylittledeb/usr/share/doc install -g 0 -o 0 -m 644 -p debian/README.Debian debian/mylittledeb/usr/share/doc/mylittledeb/README.Debian install -g 0 -o 0 -m 644 -p debian/copyright debian/mylittledeb/usr/share/doc/mylittledeb/copyright dh_installchangelogs install -o 0 -g 0 -p -m644 debian/changelog debian/mylittledeb/usr/share/doc/mylittledeb/changelog.Debian dh_perl dh_link dh_compress cd debian/mylittledeb chmod ax usr/share/doc/mylittledeb/changelog.Debian gzip -9nf usr/share/doc/mylittledeb/changelog.Debian cd '/root/mylittledeb' dh_fixperms find debian/mylittledeb -print0 2>/dev/null | xargs -0r chown --no-dereference 0:0 find debian/mylittledeb ! -type l -print0 2>/dev/null | xargs -0r chmod go=rX,u+rw,as find debian/mylittledeb/usr/share/doc -type f ! -regex 'debian/mylittledeb/usr/share/doc/[^/]*/examples/.*' -print0 2>/dev/null | xargs -0r chmod 644 find debian/mylittledeb/usr/share/doc -type d -print0 2>/dev/null | xargs -0r chmod 755 find debian/mylittledeb/usr/share/man debian/mylittledeb/usr/man/ debian/mylittledeb/usr/X11*/man/ -type f -print0 2>/dev/null | xargs -0r chmod 644 find debian/mylittledeb -perm -5 -type f \( -name '*.so.*' -or -name '*.so' -or -name '*.la' -or -name '*.a' \) -print0 2>/dev/null | xargs -0r chmod 644 find debian/mylittledeb/usr/include -type f -print0 2>/dev/null | xargs -0r chmod 644 find debian/mylittledeb/usr/share/applications -type f -print0 2>/dev/null | xargs -0r chmod 644 find debian/mylittledeb -perm -5 -type f \( -name '*.cmxs' \) -print0 2>/dev/null | xargs -0r chmod 644 find debian/mylittledeb/usr/lib/perl5 debian/mylittledeb/usr/share/perl5 -type f -perm -5 -name '*.pm' -print0 2>/dev/null | xargs -0r chmod aX find debian/mylittledeb/usr/bin -type f -print0 2>/dev/null | xargs -0r chmod a+x find debian/mylittledeb/usr/lib -type f -name '*.ali' -print0 2>/dev/null | xargs -0r chmod uga-w dh_strip strip --remove-section=.comment --remove-section=.note debian/mylittledeb/usr/bin/hello dh_makeshlibs rm -f debian/mylittledeb/DEBIAN/shlibs dh_shlibdeps install -o 0 -g 0 -d debian/mylittledeb/DEBIAN dpkg-shlibdeps -Tdebian/mylittledeb.substvars debian/mylittledeb/usr/bin/hello dh_installdeb dh_gencontrol echo misc:Depends= >> debian/mylittledeb.substvars dpkg-gencontrol -ldebian/changelog -Tdebian/mylittledeb.substvars -Pdebian/mylittledeb chmod 644 debian/mylittledeb/DEBIAN/control chown 0:0 debian/mylittledeb/DEBIAN/control dh_md5sums (cd debian/mylittledeb >/dev/null ; find . -type f ! -regex './DEBIAN/.*' -printf '%P\0' | LC_ALL=C sort -z | xargs -r0 md5sum > DEBIAN/md5sums) >/dev/null chmod 644 debian/mylittledeb/DEBIAN/md5sums chown 0:0 debian/mylittledeb/DEBIAN/md5sums dh_builddeb dpkg-deb --build debian/mylittledeb .. dpkg-deb: building package `mylittledeb' in `../mylittledeb_0.0.1-1_amd64.deb'. signfile mylittledeb_0.0.1-1.dsc gpg: skipped "root <root@unknown>": secret key not available gpg: [stdin]: clearsign failed: secret key not available dpkg-genchanges >../mylittledeb_0.0.1-1_amd64.changes dpkg-genchanges: including full source code in upload dpkg-source --after-build mylittledeb dpkg-buildpackage: full upload (original source is included) dpkg-buildpackage: warning: failed to sign .dsc and .changes file
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

上記のように、GPGキーが作成されていないため、変更に署名することができなかったことに注意してください。 このようなエラーを受け取ったという事実にもかかわらず、パッケージは実際に正常に作成されました。



これで、mylittledebフォルダーが置かれているのと同じディレクトリーに一連の新しいファイルが表示されるはずです。 次のコマンドを使用してインストールできる「mylittledeb_0.0.1-1_amd64.deb」というファイルに興味があります。

 sudo dpkg -i mylittledeb_0.0.1–1_amd64.deb
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

これで、コンピューターのどこからでも「Hello」を実行して、「Hello、World」というテキストを取得できるはずです。