Red Hat Training
A Red Hat training course is available for RHEL 8
4.7. RPM のサニティーチェック
パッケージを作成した後、パッケージの品質をチェックする必要があります。
パッケージの品質をチェックするための主なツールは rpmlint です。
rpmlint ツールは、以下のことを行います。
- RPM の保守性の向上。
- RPM の静的な分析の実行によるサニティーチェック。
- RPM の静的な分析の実行による、エラーチェック。
rpmlint ツールは、バイナリー RPM、ソース RPM (SRPM)、および SPEC ファイルをチェックできます。したがって、このツールはパッケージ化のすべての段階で役立ちます。
rpmlint のガイドラインは厳密なものです。したがって、次の例に示すように、エラーや警告の一部をスキップしてもよい場合があります。
以下のセクションで説明する例では、rpmlint にオプションを指定せずに実行しており、詳細な出力が得られません。各エラーまたは警告の詳細な説明は、代わりに rpmlint -i を実行してください。
4.7.1. bello のサニティーチェック
次のセクションでは、bello SPEC ファイルと bello バイナリー RPM を例に、RPM のサニティーチェックを行うときに発生する可能性のある警告とエラーを調べます。
4.7.1.1. bello SPEC ファイルのサニティーチェック
次の例の出力を調べて、bello SPEC ファイルのサニティーチェックを行う方法を確認してください。
例4.3 bello の SPEC ファイルでの rpmlint コマンド実行の出力
以下は、bello SPEC ファイルに対して実行した rpmlint コマンドの出力例です。
$ rpmlint bello.spec
bello.spec: W: invalid-url Source0: https://www.example.com/bello/releases/bello-0.1.tar.gz HTTP Error 404: Not Found
0 packages and 1 specfiles checked; 0 errors, 1 warnings.
bello.spec については、警告が 1 つだけあります。invalid-url Source0という警告は、Source0 ディレクティブにリストされている URL に到達できないことを意味します。example.com URL は存在しないため、この出力は当然です。この URL が今後有効になると仮定して、この警告を無視します。
例4.4 bello の SRPM で rpmlint コマンドを実行した場合の出力
以下は、bello ソース RPM (SRPM) に対して実行した rpmlint コマンドの出力例です。
$ rpmlint ~/rpmbuild/SRPMS/bello-0.1-1.el8.src.rpm
bello.src: W: invalid-url URL: https://www.example.com/bello HTTP Error 404: Not Found
bello.src: W: invalid-url Source0: https://www.example.com/bello/releases/bello-0.1.tar.gz HTTP Error 404: Not Found
1 packages and 0 specfiles checked; 0 errors, 2 warnings.
bello SRPM については、invalid-url URL という新しい警告があります。この警告は、URL ディレクティブで指定された URL に到達できないことを意味します。この URL が今後有効になると仮定して、この警告を無視します。
4.7.1.2. bello バイナリー RPM のサニティーチェック
バイナリー RPM をチェックする場合、rpmlint コマンドは次の項目をチェックします。
- ドキュメント
- man ページ
- ファイルシステム階層規格の一貫した使用
次の例の出力を調べて、bello バイナリー RPM のサニティーチェックを行う方法を確認してください。
例4.5 bello のバイナリー RPM での rpmlint コマンドの実行の出力
以下は、bello バイナリー RPM に対して実行した rpmlint コマンドの出力例です。
$ rpmlint ~/rpmbuild/RPMS/noarch/bello-0.1-1.el8.noarch.rpm
bello.noarch: W: invalid-url URL: https://www.example.com/bello HTTP Error 404: Not Found
bello.noarch: W: no-documentation
bello.noarch: W: no-manual-page-for-binary bello
1 packages and 0 specfiles checked; 0 errors, 3 warnings.
no-documentation および no-manual-page-for-binary という警告は、ユーザーがドキュメントや man ページを提供しなかったため、RPM にドキュメントや man ページがないことを意味します。出力の警告を別にすれば、RPM は rpmlint チェックに合格しています。
4.7.2. pello のサニティーチェック
次のセクションでは、pello SPEC ファイルと pello バイナリー RPM を例に、RPM のサニティーチェックを行うときに発生する可能性のある警告とエラーを調べます。
4.7.2.1. pello SPEC ファイルのサニティーチェック
次の例の出力を調べて、pello SPEC ファイルのサニティーチェックを行う方法を確認してください。
例4.6 pello の SPEC ファイルで rpmlint コマンドを実行した場合の出力
以下は、pello SPEC ファイルに対して実行した rpmlint コマンドの出力例です。
$ rpmlint pello.spec
pello.spec:30: E: hardcoded-library-path in %{buildroot}/usr/lib/%{name}
pello.spec:34: E: hardcoded-library-path in /usr/lib/%{name}/%{name}.pyc
pello.spec:39: E: hardcoded-library-path in %{buildroot}/usr/lib/%{name}/
pello.spec:43: E: hardcoded-library-path in /usr/lib/%{name}/
pello.spec:45: E: hardcoded-library-path in /usr/lib/%{name}/%{name}.py*
pello.spec: W: invalid-url Source0: https://www.example.com/pello/releases/pello-0.1.2.tar.gz HTTP Error 404: Not Found
0 packages and 1 specfiles checked; 5 errors, 1 warnings.-
invalid-url Source0という警告は、Source0ディレクティブにリストされている URL に到達できないことを意味します。example.comURL は存在しないため、この出力は当然です。この URL が今後有効になると仮定して、この警告を無視します。
-
hardcoded-library-pathというエラーは、ライブラリーパスをハードコーディングする代わりに%{_libdir}マクロを使用することを提案しています。この例では、これらのエラーは無視しても問題はありません。ただし、実稼働環境に導入するパッケージの場合は、すべてのエラーを慎重に確認してください。
例4.7 pello の SRPM で rpmlint コマンドを実行した場合の出力
以下は、pello ソース RPM (SRPM) に対して実行した rpmlint コマンドの出力例です。
$ rpmlint ~/rpmbuild/SRPMS/pello-0.1.2-1.el8.src.rpm
pello.src: W: invalid-url URL: https://www.example.com/pello HTTP Error 404: Not Found
pello.src:30: E: hardcoded-library-path in %{buildroot}/usr/lib/%{name}
pello.src:34: E: hardcoded-library-path in /usr/lib/%{name}/%{name}.pyc
pello.src:39: E: hardcoded-library-path in %{buildroot}/usr/lib/%{name}/
pello.src:43: E: hardcoded-library-path in /usr/lib/%{name}/
pello.src:45: E: hardcoded-library-path in /usr/lib/%{name}/%{name}.py*
pello.src: W: invalid-url Source0: https://www.example.com/pello/releases/pello-0.1.2.tar.gz HTTP Error 404: Not Found
1 packages and 0 specfiles checked; 5 errors, 2 warnings.
invalid-url URL エラーは、到達不能な URL ディレクティブに関するものです。この URL が今後有効になると仮定して、この警告を無視します。
4.7.2.2. pello バイナリー RPM のサニティーチェック
バイナリー RPM をチェックする場合、rpmlint コマンドは次の項目をチェックします。
- ドキュメント
- man ページ
- ファイルシステム階層規格の一貫した使用
次の例の出力を調べて、pello バイナリー RPM のサニティーチェックを行う方法を確認してください。
例4.8 pello のバイナリー RPM での rpmlint コマンドの実行の出力
以下は、pello バイナリー RPM に対して実行した rpmlint コマンドの出力例です。
$ rpmlint ~/rpmbuild/RPMS/noarch/pello-0.1.2-1.el8.noarch.rpm
pello.noarch: W: invalid-url URL: https://www.example.com/pello HTTP Error 404: Not Found
pello.noarch: W: only-non-binary-in-usr-lib
pello.noarch: W: no-documentation
pello.noarch: E: non-executable-script /usr/lib/pello/pello.py 0644L /usr/bin/env
pello.noarch: W: no-manual-page-for-binary pello
1 packages and 0 specfiles checked; 1 errors, 4 warnings.-
no-documentationおよびno-manual-page-for-binaryという警告は、ユーザーがドキュメントや man ページを提供しなかったため、RPM にドキュメントや man ページがないことを意味します。 Only-non-binary-in-usr-libという警告は、/usr/lib/ディレクトリーにバイナリーでないアーティファクトしかないことを意味します。このディレクトリーは通常、バイナリーファイルである共有オブジェクトファイル用に予約されています。したがって、rpmlintは、/usr/lib/内の少なくとも 1 つ以上のファイルがバイナリーであることを想定します。これは、ファイルシステム階層規格への準拠についての
rpmlintチェック例です。通常、ファイルを正しく配置するには RPM マクロを使用します。この例では、この警告は無視しても問題はありません。-
non-executable-scriptというエラーは、/usr/lib/pello/pello.pyファイルに実行権限がないことを意味します。ファイルにシバンが含まれているため、rpmlintツールは、ファイルが実行ファイルであること想定します。この例では、このファイルは実行権限なしのままにし、このエラーを無視します。
出力の警告とエラーを別にすれば、RPM は rpmlint チェックに合格しています。
4.7.3. cello のサニティーチェック
次のセクションでは、cello SPEC ファイルと cello バイナリー RPM を例に、RPM のサニティーチェックを行うときに発生する可能性のある警告とエラーを調べます。
4.7.3.1. cello SPEC ファイルのサニティーチェック
次の例の出力を調べて、cello SPEC ファイルのサニティーチェックを行う方法を確認します。
例4.9 cello の SPEC で rpmlint コマンドを実行した場合の出力
以下は、cello SPEC ファイルに対して実行した rpmlint コマンドの出力例です。
$ rpmlint ~/rpmbuild/SPECS/cello.spec
/home/admiller/rpmbuild/SPECS/cello.spec: W: invalid-url Source0: https://www.example.com/cello/releases/cello-1.0.tar.gz HTTP Error 404: Not Found
0 packages and 1 specfiles checked; 0 errors, 1 warnings.
cello.spec については、警告が 1 つだけあります。invalid-url Source0という警告は、Source0 ディレクティブにリストされている URL に到達できないことを意味します。example.com URL は存在しないため、この出力は当然です。この URL が今後有効になると仮定して、この警告を無視します。
例4.10 cello の SRPM で rpmlint コマンドを実行した場合の出力
以下は、cello ソース RPM (SRPM) に対して実行した rpmlint コマンドの出力例です。
$ rpmlint ~/rpmbuild/SRPMS/cello-1.0-1.el8.src.rpm
cello.src: W: invalid-url URL: https://www.example.com/cello HTTP Error 404: Not Found
cello.src: W: invalid-url Source0: https://www.example.com/cello/releases/cello-1.0.tar.gz HTTP Error 404: Not Found
1 packages and 0 specfiles checked; 0 errors, 2 warnings.
cello SRPM については、invalid-url URL という新しい警告があります。この警告は、URL ディレクティブで指定された URL に到達できないことを意味します。この URL が今後有効になると仮定して、この警告を無視します。
4.7.3.2. cello バイナリー RPM のサニティーチェック
バイナリー RPM をチェックする場合、rpmlint コマンドは次の項目をチェックします。
- ドキュメント
- man ページ
- ファイルシステム階層規格の一貫した使用
次の例の出力を調べて、cello バイナリー RPM のサニティーチェックを行う方法を確認してください。
例4.11 cello のバイナリー RPM で rpmlint コマンドを実行した場合の出力
以下は、cello バイナリー RPM に対して実行した rpmlint コマンドの出力例です。
$ rpmlint ~/rpmbuild/RPMS/x86_64/cello-1.0-1.el8.x86_64.rpm
cello.x86_64: W: invalid-url URL: https://www.example.com/cello HTTP Error 404: Not Found
cello.x86_64: W: no-documentation
cello.x86_64: W: no-manual-page-for-binary cello
1 packages and 0 specfiles checked; 0 errors, 3 warnings.
no-documentation および no-manual-page-for-binary という警告は、ユーザーがドキュメントや man ページを提供しなかったため、RPM にドキュメントや man ページがないことを意味します。
出力の警告を別にすれば、RPM は rpmlint チェックに合格しています。
