Language:
Format:

소프트웨어 패키징 및 배포

Red Hat Enterprise Linux 9

RPM 패키지 관리 시스템을 사용하여 소프트웨어 패키지 패키지

Red Hat Customer Content Services

초록

RPM 패키지 관리자를 사용하여 소프트웨어를 RPM 패키지로 패키징합니다. 패키징, 패키지 소프트웨어용으로 소스 코드를 준비하고, Python 프로젝트 패키징 또는 RubyGems와 같은 고급 패키징 시나리오를 RPM 패키지로 조사합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 용어를 교체하기 위해 최선을 다하고 있습니다. 먼저 마스터(master), 슬레이브(slave), 블랙리스트(blacklist), 화이트리스트(whitelist) 등 네 가지 용어를 교체하고 있습니다. 이러한 변경 작업은 작업 범위가 크므로 향후 여러 릴리스에 걸쳐 점차 구현할 예정입니다. 자세한 내용은 CTO Chris Wright의 메시지를 참조하십시오.

Red Hat 문서에 관한 피드백 제공

문서에 대한 피드백에 감사드립니다. 어떻게 개선할 수 있는지 알려주십시오.

Jira를 통해 피드백 제출 (등록 필요)

Jira 웹 사이트에 로그인합니다.
상단 탐색 모음에서 생성 을 클릭합니다.
Summary (요약) 필드에 설명 제목을 입력합니다.
Description (설명) 필드에 개선을 위한 제안을 입력합니다. 문서의 관련 부분에 대한 링크를 포함합니다.
대화 상자 하단에서 생성 을 클릭합니다.

1장. RPM 소개

RPM(RPM)은 RHEL(Red Hat Enterprise Linux), CentOS 및 Fedora에서 실행되는 패키지 관리 시스템입니다. RPM을 사용하여 이러한 운영 체제에 대해 생성하는 소프트웨어를 배포, 관리 및 업데이트할 수 있습니다.

RPM 패키지 관리 시스템은 기존 아카이브 파일에 소프트웨어를 배포하는 것보다 다음과 같은 이점이 있습니다.

RPM은 서로 독립적으로 설치, 업데이트 또는 제거할 수 있는 패키지 형태로 소프트웨어를 관리하므로 운영 체제를 보다 쉽게 유지 관리할 수 있습니다.
RPM 패키지는 압축된 아카이브와 유사하게 독립 실행형 바이너리 파일이므로 RPM을 단순화합니다. 이러한 패키지는 특정 운영 체제 및 하드웨어 아키텍처를 위해 빌드됩니다. RPM에는 패키지가 설치될 때 파일 시스템의 적절한 경로에 배치되는 컴파일된 실행 파일 및 라이브러리와 같은 파일이 포함되어 있습니다.

RPM을 사용하면 다음 작업을 수행할 수 있습니다.

패키지 소프트웨어를 설치, 업그레이드 및 제거합니다.
패키지 소프트웨어에 대한 자세한 정보를 쿼리합니다.
패키지 소프트웨어의 무결성을 확인합니다.
소프트웨어 소스에서 자체 패키지를 빌드하고 빌드 지침을 완료합니다.
GPG(GNU Privacy Guard) 유틸리티를 사용하여 패키지에 디지털 서명합니다.
DNF 리포지토리에 패키지를 게시합니다.

Red Hat Enterprise Linux에서 RPM은 DNF 또는 PackageKit과 같은 고급 패키지 관리 소프트웨어에 완전히 통합되어 있습니다. RPM은 자체 명령줄 인터페이스를 제공하지만 대부분의 사용자는 이 소프트웨어를 통해서만 RPM과 상호 작용해야 합니다. 그러나 RPM 패키지를 빌드할 때는 rpmbuild(8) 와 같은 RPM 유틸리티를 사용해야 합니다.

1.1. RPM 패키지

RPM 패키지는 이러한 파일을 설치 및 삭제하는 데 사용되는 파일 및 메타데이터의 아카이브로 구성됩니다. 특히 RPM 패키지에는 다음 부분이 포함되어 있습니다.

GPG 서명
GPG 서명은 패키지의 무결성을 확인하는 데 사용됩니다.
헤더(패키지 메타데이터)
RPM 패키지 관리자는 이 메타데이터를 사용하여 패키지 종속성, 파일 설치 위치 및 기타 정보를 확인합니다.
페이로드
페이로드는 시스템에 설치할 파일이 포함된 cpio 아카이브입니다.

RPM 패키지에는 두 가지 유형이 있습니다. 두 유형 모두 파일 형식과 툴링을 공유하지만 콘텐츠가 다르며 다른 용도로 사용됩니다.

소스 RPM(SRPM)
SRPM에는 소스 코드와 SPEC 파일이 포함되어 있습니다. 이 파일은 소스 코드를 바이너리 RPM에 빌드하는 방법을 설명합니다. 선택적으로 SRPM은 소스 코드에 대한 패치를 포함할 수 있습니다.
바이너리 RPM
바이너리 RPM에는 소스 및 패치에서 빌드된 바이너리가 포함되어 있습니다.

1.2. RPM 패키징 유틸리티 나열

RPM은 패키지 빌드를 위한 rpmbuild(8) 프로그램 외에도 다른 유틸리티를 제공하여 패키지 생성 프로세스를 보다 쉽게 수행할 수 있도록 합니다. 이러한 프로그램은 rpmdevtools 패키지에서 찾을 수 있습니다.

사전 요구 사항

rpmdevtools 패키지가 설치되었습니다.
```
# dnf install rpmdevtools
```

절차

다음 방법 중 하나를 사용하여 RPM 패키징 유틸리티를 나열합니다.
- rpmdevtools 패키지에서 제공하는 특정 유틸리티와 짧은 설명을 나열하려면 다음을 입력합니다.
```
$ rpm -qi rpmdevtools
```
- 모든 유틸리티를 나열하려면 다음을 입력합니다.
```
$ rpm -ql rpmdevtools | grep ^/usr/bin
```

추가 리소스

RPM 유틸리티 도움말 페이지

2장. RPM 패키징 소프트웨어 생성

RPM 패키징용 소프트웨어를 준비하려면 소스 코드가 무엇이며 소프트웨어 생성 방법을 이해해야 합니다.

2.1. 소스 코드란

소스 코드는 계산을 수행하는 방법을 설명하는 컴퓨터에 대해 사람이 읽을 수 있는 명령입니다. 소스 코드는 프로그래밍 언어를 사용하여 표현됩니다.

세 가지 프로그래밍 언어로 작성된 Hello World 프로그램의 다음 버전은 주요 RPM 패키지 관리자 사용 사례를 다룹니다.

bash로 작성된 hello world
bello 프로젝트는 Bash 에서 Hello World 를 구현합니다. 구현에는 bello 쉘 스크립트만 포함됩니다. 이 프로그램의 목적은 명령줄에서 Hello World 를 출력하는 것입니다.
벨로 파일에는 다음 내용이 있습니다.
```
#!/bin/bash

printf "Hello World\n"
```

Hello World 는 Python으로 작성됩니다.
pello 프로젝트는 Python 에서 Hello World 를 구현합니다. 구현에는 pello.py 프로그램만 포함됩니다. 프로그램의 목적은 명령행에 Hello World 를 출력하는 것입니다.
pello.py 파일에는 다음과 같은 내용이 있습니다.
```
#!/usr/bin/python3

print("Hello World")
```

Hello World 에서 C로 작성됩니다.
cello 프로젝트는 Hello World in C를 구현합니다. 구현에는 cello.c 및 Makefile 파일만 포함됩니다. 따라서 생성된 tar.gz 아카이브에는 LICENSE 파일 외에 두 개의 파일이 있습니다. 프로그램의 목적은 명령줄에서 Hello World 를 출력하는 것입니다.
cello.c 파일에는 다음과 같은 내용이 있습니다.
```
#include <stdio.h>

int main(void) {
    printf("Hello World\n");
    return 0;
}
```

참고

패키징 프로세스는 Hello World 프로그램의 각 버전에 따라 다릅니다.

2.2. 소프트웨어 생성 방법

다음 방법 중 하나를 사용하여 사람이 읽을 수 있는 소스 코드를 머신 코드로 변환할 수 있습니다.

기본적으로 소프트웨어를 컴파일 합니다.
언어 인터프리터 또는 언어 가상 머신을 사용하여 소프트웨어를 해석 합니다. raw-interpret 또는 byte-compile 소프트웨어 중 하나를 사용할 수 있습니다.

2.2.1. 기본적으로 컴파일된 소프트웨어

기본적으로 컴파일된 소프트웨어는 결과 바이너리 실행 파일을 사용하여 머신 코드로 컴파일되는 프로그래밍 언어로 작성된 소프트웨어입니다. 기본적으로 컴파일된 소프트웨어는 독립 실행형 소프트웨어입니다.

참고

기본적으로 컴파일된 RPM 패키지는 아키텍처에 따라 다릅니다.

64비트(x86_64) AMD 또는 Intel 프로세서를 사용하는 컴퓨터에서 이러한 소프트웨어를 컴파일하면 32비트(x86) AMD 또는 Intel 프로세서에서 실행되지 않습니다. 결과 패키지에는 이름에 지정된 아키텍처가 있습니다.

2.2.2. 해석된 소프트웨어

Bash 또는 Python 과 같은 일부 프로그래밍 언어는 머신 코드로 컴파일되지 않습니다. 대신 언어 인터프리터 또는 언어 가상 머신은 사전 변환 없이 프로그램의 소스 코드를 단계별로 실행합니다.

참고

해석된 프로그래밍 언어로 전체적으로 작성된 소프트웨어는 아키텍처에 국한되지 않습니다. 따라서 결과 RPM 패키지에는 이름에 noarch 문자열이 있습니다.

해석된 언어로 작성된 raw-interpret 또는 byte-compile 소프트웨어 중 하나를 사용할 수 있습니다.

원시 중단 소프트웨어
이러한 유형의 소프트웨어를 컴파일할 필요는 없습니다. 원시 해석 소프트웨어는 인터프리터에 의해 직접 실행됩니다.
바이트로 컴파일된 소프트웨어
먼저 이 유형의 소프트웨어를 바이트 코드로 컴파일해야 하며, 그런 다음 언어 가상 머신에서 실행해야 합니다.
참고
일부 바이트로 컴파일된 언어는 원시 해석 또는 바이트 컴파일될 수 있습니다.

RPM을 사용하여 소프트웨어를 빌드하고 패키지하는 방법은 두 가지 소프트웨어 유형에 따라 다릅니다.

2.3. 소스에서 소프트웨어 빌드

소프트웨어 빌드 프로세스 중에 소스 코드는 RPM을 사용하여 패키징할 수 있는 소프트웨어 아티팩트로 변환됩니다.

2.3.1. 기본적으로 컴파일된 코드에서 소프트웨어 빌드

다음 방법 중 하나를 사용하여 컴파일된 언어로 작성된 소프트웨어를 실행 파일로 빌드할 수 있습니다.

수동 빌딩
자동화된 빌드

다음 섹션에서는 수동 또는 자동화된 빌드를 사용하여 C 프로그래밍 언어로 작성된 Hello World 프로그램을 빌드하는 방법을 알아봅니다.

2.3.1.1. 수동으로 `cello` 소프트웨어 빌드

수동 빌드를 사용하여 컴파일된 언어로 작성된 소프트웨어를 빌드할 수 있습니다.

C (cello.c)로 작성된 hello World 에는 다음과 같은 내용이 있습니다.

#include <stdio.h>

int main(void) {
    printf("Hello World\n");
    return 0;
}

절차

GNU 컴파일러 컬렉션에서 C 컴파일러를 호출하여 소스 코드를 바이너리로 컴파일합니다.
```
$ gcc -g -o cello cello.c
```
결과 바이너리 셀로를 실행합니다.
```
$ ./cello
Hello World
```

2.3.1.2. 셀오 프로그램에 대한 자동화된 빌딩 설정

대규모 소프트웨어는 일반적으로 자동화된 빌드를 사용합니다. Makefile 파일을 만든 다음 GNU make 유틸리티를 실행하여 자동화된 빌드를 설정할 수 있습니다.

절차

cello.c 와 동일한 디렉토리에 다음 콘텐츠를 사용하여 Makefile 파일을 만듭니다.
```
cello:
	gcc -g -o cello cello.c
clean:
	rm cello
```
cello: 및 clean 아래의 줄은 탭 문자(tab)로 시작해야 합니다.
소프트웨어를 빌드합니다.
```
$ make
make: 'cello' is up to date.
```
빌드는 현재 디렉터리에서 이미 사용할 수 있으므로 make clean 명령을 입력한 다음 make 명령을 다시 입력합니다.
```
$ make clean
rm cello

$ make
gcc -g -o cello cello.c
```
이 시점에서 프로그램을 다시 빌드하려는 경우 GNU make 시스템이 기존 바이너리를 감지하므로 영향을 미치지 않습니다.
```
$ make
make: 'cello' is up to date.
```
프로그램을 실행합니다.
```
$ ./cello
Hello World
```

2.3.2. 소스 코드 해석

해석된 프로그래밍 언어로 작성된 소스 코드를 다음 방법 중 하나를 사용하여 머신 코드로 변환할 수 있습니다.

바이트 컴파일
바이트 컴파일 소프트웨어의 절차는 다음 요인에 따라 다릅니다.
- 프로그래밍 언어
- 언어의 가상 머신
- 해당 언어로 사용되는 툴 및 프로세스
  참고
  예를 들어 Python 에서 작성된 소프트웨어를 바이트로 작성할 수 있습니다. 배포를 위해 설계된 Python 소프트웨어는 종종 바이트로 컴파일되지만 이 문서에서 설명하는 방식에는 포함되지 않습니다. 설명된 절차는 커뮤니티 표준을 준수하는 것이 아니라 간단하게 하는 것을 목표로 합니다. 실제 Python 지침은 소프트웨어 패키징 및 배포를 참조하십시오.
또한 원시 해석 Python 소스 코드도 사용할 수 있습니다. 그러나 바이트로 컴파일된 버전이 더 빠릅니다. 따라서 RPM 패키지는 최종 사용자에게 배포하기 위해 바이트로 컴파일된 버전을 패키징하는 것을 선호합니다.
Raw-interpreting
Bash 와 같은 쉘 스크립팅 언어로 작성된 소프트웨어는 항상 원시 해석에 의해 실행됩니다.

다음 섹션에서는 Python으로 작성된 Hello World 프로그램을 바이트로 컴파일하는 방법과 Bash로 작성된 Hello World 프로그램을 원시 화하는 방법을 알아봅니다.

2.3.2.1. `pello` 프로그램 바이트 컴파일

Python 소스 코드의 원시 해석을 통해 바이트 컴파일을 선택하면 더 빠른 소프트웨어를 만들 수 있습니다.

Python 프로그래밍 언어(pello.py)로 작성된 Hello World 프로그램에는 다음과 같은 내용이 있습니다.

print("Hello World")

절차

pello.py 파일을 바이트 압축합니다.
```
$ python -m compileall pello.py
```
바이트로 컴파일된 파일 버전이 생성되었는지 확인합니다.
```
$ $ ls __pycache__
pello.cpython-311.pyc
```
출력의 패키지 버전은 설치된 Python 버전에 따라 다를 수 있습니다.
pello.py 에서 프로그램을 실행합니다.
```
$ python pello.py
Hello World
```

2.3.2.2. Bello 프로그램 원시 `중단`

Bash 쉘로 작성된 Hello World 프로그램(벨로)에는 다음과 같은 내용이 있습니다.

#!/bin/bash

printf "Hello World\n"

참고

벨로 파일의 상단에 있는 shebang (#!)기호는 프로그래밍 언어 소스 코드의 일부가 아닙니다.

shebang 을 사용하여 텍스트 파일을 실행 파일로 전환합니다. 시스템 프로그램 로더는 shebang 이 포함된 행을 구문 분석하여 바이너리 실행 파일의 경로를 가져온 다음 프로그래밍 언어 인터프리터로 사용됩니다.

절차

소스 코드로 파일을 실행 가능하게 만듭니다.
```
$ chmod +x bello
```
생성된 파일을 실행합니다.
```
$ ./bello
Hello World
```

3장. RPM 패키지 소프트웨어 준비

다음 섹션에서는 RPM 패키지용 소프트웨어를 준비하는 방법을 알아봅니다.

소프트웨어를 패치 하는 방법을 알아보십시오.
LICENSE 파일을 만듭니다.
tarball에 소스 코드를 배치하는 방법을 알아보십시오.

3.1. 패치 소프트웨어

소프트웨어를 패키징할 때는 버그 수정 또는 구성 파일 변경과 같은 원래 소스 코드를 변경해야 할 수 있습니다. RPM 패키징에서는 원래 소스 코드를 그대로 두고 패치만 적용할 수 있습니다.

패치는 소스 코드 파일을 업데이트하는 텍스트입니다. 패치는 두 버전의 텍스트의 차이를 나타내기 때문에 diff 형식이 있습니다. diff 유틸리티를 사용하여 패치를 생성한 다음 patch 유틸리티를 사용하여 소스 코드에 패치를 적용할 수 있습니다.

참고

소프트웨어 개발자는 종종 Git 과 같은 버전 제어 시스템을 사용하여 코드 기반을 관리합니다. 이러한 도구는 diffs 또는 Patch 소프트웨어를 만드는 자체 방법을 제공합니다.

다음 섹션에서는 C 프로그래밍 언어로 작성된 Hello World 프로그램에 대한 패치를 만드는 방법과 이 프로그램을 패치 하는 방법을 알아봅니다.

3.1.1. `cello` 프로그램에 대한 패치 파일 생성

diff 유틸리티를 사용하여 원래 소스 코드에서 패치를 생성할 수 있습니다.

절차

원본 소스 코드를 유지합니다.
```
$ cp -p cello.c cello.c.orig
```
p 옵션은 모드, 소유권 및 타임스탬프를 유지합니다.

필요에 따라 cello.c 를 수정합니다.

#include <stdio.h>

int main(void) {
    printf("Hello World from my very first patch!\n");
    return 0;
}

패치를 생성합니다.
```
$ diff -Naur cello.c.orig cello.c
--- cello.c.orig        2016-05-26 17:21:30.478523360 -0500
+ cello.c     2016-05-27 14:53:20.668588245 -0500
@@ -1,6 +1,6 @@
 #include<stdio.h>

 int main(void){
-    printf("Hello World!\n");
+    printf("Hello World from my very first patch!\n");
     return 0;
 }
\ No newline at end of file
```
+ 로 시작하는 줄은 - 로 시작하는 행을 바꿉니다.
참고
대부분의 사용 사례에 적합하므로 diff 명령과 함께 n ur 옵션을 사용하는 것이 좋습니다.
- - n (--new-file)
  N 옵션은 없는 파일을 빈 파일로 처리합니다.
- -a (--text)
  a 옵션은 모든 파일을 텍스트로 처리합니다. 결과적으로 diff 유틸리티는 바이너리로 분류된 파일을 무시하지 않습니다.
- -u (-U NUM 또는 --unified[=NUM])
  -u 옵션은 통합 컨텍스트의 출력 NUM(기본값 3) 줄로 출력을 반환합니다. 이는 패치 파일에서 일반적으로 사용되는 컴팩트하고 쉽게 읽을 수 있는 형식입니다.
- -r (--recursive)
  r 옵션은 diff 유틸리티에서 발견된 하위 디렉토리를 재귀적으로 비교합니다.
그러나 이 특별한 경우에는 -u 옵션만 필요합니다.

패치를 파일에 저장합니다.

$ diff -Naur cello.c.orig cello.c > cello.patch

원본 cello.c 를 복원 :
```
$ mv cello.c.orig cello.c
```
RPM 패키지를 빌드할 때 RPM 패키지 관리자가 수정된 파일이 아닌 원본 파일을 사용하므로 원래 cello.c 를 유지해야 합니다. 자세한 내용은 SPEC 파일 작업을 참조하십시오.

추가 리소스

diff(1) 도움말 페이지

3.1.2. 셀로 `프로그램` 패치

패치 유틸리티를 사용하여 소프트웨어를 패치 할 수 있습니다.

사전 요구 사항

원래 소스 코드의 패치 가 생성되었습니다.

절차

패치 파일을 패치 명령으로 리디렉션합니다.
```
$ patch < cello.patch
patching file cello.c
```

cello.c 의 내용이 이제 원하는 변경 사항을 반영하는지 확인합니다.

$ cat cello.c
#include<stdio.h>

int main(void){
    printf("Hello World from my very first patch!\n");
    return 1;
}

패치된 cello.c 프로그램을 빌드합니다.
```
$ make
gcc -g -o cello cello.c
```

빌드된 cello.c 프로그램을 실행합니다.

$ ./cello
Hello World from my very first patch!

3.2. `LICENSE` 파일 만들기

소프트웨어 라이센스 파일은 사용자에게 소스 코드로 수행할 수 있는 작업을 사용자에게 알립니다.

소스 코드에 대한 라이센스가 없으면 이 코드에 대한 모든 권한을 보유하고 소스 코드에서 파생 작업을 재현, 배포 또는 생성할 수 없습니다.

중요

소프트웨어 라이센스와 함께 소프트웨어를 배포하는 것이 좋습니다.

절차

필요한 라이센스 문을 사용하여 LICENSE 파일을 생성합니다.
```
$ vim LICENSE
```

예 3.1. GPLv3 LICENSE 파일 텍스트 예

$ cat /tmp/LICENSE
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

추가 리소스

sorce 코드 예

3.3. 소스 코드를 tarball에 배치

tarball은 .tar.gz 또는 .tgz 접미사가 있는 아카이브 파일입니다. 소스 코드를 tarball에 배치하는 것은 나중에 배포를 위해 패키징할 소프트웨어를 릴리스하는 일반적인 방법입니다.

다음 섹션에서 세 가지 Hello World 프로그램 버전을 gzip-compressed tarball에 배치하는 방법을 알아봅니다.

bello 프로그램을 tarball에 넣습니다.
pello 프로그램을 tarball에 넣습니다.
cello 프로그램을 tarball에 넣습니다.

3.3.1. 벨로 `프로그램을` tarball에 배치

bello 프로젝트는 Bash 에서 Hello World 를 구현합니다. 구현에는 bello 쉘 스크립트만 포함됩니다. 따라서 생성된 tar.gz 아카이브에는 LICENSE 파일 외에 하나의 파일만 있습니다.

사전 요구 사항

bello 프로그램의 0.1 버전이 사용된다고 가정합니다.

절차

필요한 모든 파일을 단일 디렉터리에 배치합니다.

$ mkdir bello-0.1

$ mv ~/bello bello-0.1/

$ mv LICENSE bello-0.1/

배포를 위한 아카이브를 생성합니다.

$ tar -cvzf bello-0.1.tar.gz bello-0.1
bello-0.1/
bello-0.1/LICENSE
bello-0.1/bello

생성된 아카이브를 ~/rpmbuild/SOURCES/ 디렉터리로 이동합니다. 이 디렉터리는 rpmbuild 명령이 패키지 빌드용 파일을 저장하는 기본 디렉터리입니다.
```
$ mv bello-0.1.tar.gz ~/rpmbuild/SOURCES/
```

추가 리소스

bash로 작성된 hello world

3.3.2. `pello` 프로그램을 tarball에 배치

pello 프로젝트는 Python 에서 Hello World 를 구현합니다. 구현에는 pello.py 프로그램만 포함됩니다. 따라서 생성된 tar.gz 아카이브에는 LICENSE 파일 외에 하나의 파일만 있습니다.

사전 요구 사항

pello 프로그램의 0.1.1 버전이 사용되었다고 가정합니다.

절차

필요한 모든 파일을 단일 디렉터리에 배치합니다.

$ mkdir pello-0.1.1

$ mv pello.py pello-0.1.1/

$ mv LICENSE pello-0.1.1/

배포를 위한 아카이브를 생성합니다.

$ tar -cvzf pello-0.1.1.tar.gz pello-0.1.1
pello-0.1.1/
pello-0.1.1/LICENSE
pello-0.1.1/pello.py

생성된 아카이브를 ~/rpmbuild/SOURCES/ 디렉터리로 이동합니다. 이 디렉터리는 rpmbuild 명령이 패키지 빌드용 파일을 저장하는 기본 디렉터리입니다.
```
$ mv pello-0.1.1.tar.gz ~/rpmbuild/SOURCES/
```

추가 리소스

Hello World는 Python으로 작성됩니다.

3.3.3. cello 프로그램을 tarball에 배치

cello 프로젝트는 Hello World in C를 구현합니다. 구현에는 cello.c 및 Makefile 파일만 포함됩니다. 따라서 생성된 tar.gz 아카이브에는 LICENSE 파일 외에도 두 개의 파일이 있습니다.

참고

패치 파일은 프로그램과 함께 아카이브에 배포되지 않습니다. RPM 패키지 관리자는 RPM을 빌드할 때 패치를 적용합니다. 패치는 tar.gz 아카이브와 함께 ~/rpmbuild/SOURCES/ 디렉터리에 배치됩니다.

사전 요구 사항

cello 프로그램의 1.0 버전이 사용되었다고 가정합니다.

절차

필요한 모든 파일을 단일 디렉터리에 배치합니다.

$ mkdir cello-1.0

$ mv cello.c cello-1.0/

$ mv Makefile cello-1.0/

$ mv LICENSE cello-1.0/

배포를 위한 아카이브를 생성합니다.

$ tar -cvzf cello-1.0.tar.gz cello-1.0
cello-1.0/
cello-1.0/Makefile
cello-1.0/cello.c
cello-1.0/LICENSE

생성된 아카이브를 ~/rpmbuild/SOURCES/ 디렉터리로 이동합니다. 이 디렉터리는 rpmbuild 명령이 패키지 빌드용 파일을 저장하는 기본 디렉터리입니다.
```
$ mv /tmp/cello-1.0.tar.gz ~/rpmbuild/SOURCES/
```

추가 리소스

Hello World에서 C로 작성됩니다.

4장. 패키지 소프트웨어

4.1. RPM 패키지 작업 공간 설정

rpmdev-setuptree 유틸리티를 사용하여 RPM 패키징 작업 공간인 디렉터리 레이아웃을 설정할 수 있습니다.

사전 요구 사항

RPM 패키징에 몇 가지 유틸리티를 제공하는 rpmdevtools 패키지를 설치했습니다.
```
# dnf install rpmdevtools
```

절차

rpmdev-setuptree 유틸리티를 실행합니다.

$ rpmdev-setuptree

$ tree ~/rpmbuild/
/home/user/rpmbuild/
|-- BUILD
|-- RPMS
|-- SOURCES
|-- SPECS
`-- SRPMS

5 directories, 0 files

생성된 디렉터리는 다음과 같은 목적을 제공합니다.

디렉터리	목적
BUILD	패키지가 빌드되면 여기에 다양한 `%buildroot` 디렉터리가 생성됩니다. 로그 출력에 충분한 정보가 제공되지 않는 경우 실패한 빌드를 조사하는 데 유용합니다.
RPMS	바이너리 RPM은 다른 아키텍처에 대한 하위 디렉터리(예: `x86_64` 및 `noarch` )에 생성됩니다.
SOURCES	여기서 packager는 압축된 소스 코드 아카이브와 패치를 배치합니다. `rpmbuild` 명령은 여기에서 해당 명령을 찾습니다.
SPECS	패키지 관리자는 SPEC 파일을 여기에 저장합니다.
SRPMS	`rpmbuild` 를 사용하여 바이너리 RPM 대신 SRPM을 빌드할 때 결과 SRPM이 여기에 생성됩니다.

4.2. SPEC 파일이란 무엇입니까?

SPEC 파일은 rpmbuild 유틸리티에서 RPM을 빌드하는 데 사용하는 레시피로 이해할 수 있습니다. SPEC 파일은 일련의 섹션에서 지침을 정의하여 빌드 시스템에 필요한 정보를 제공합니다. 섹션은 Preamble 및 body 부분에 정의되어 있습니다. Preamble 부분에는 body 부분에서 사용되는 일련의 메타데이터 항목이 포함되어 있습니다. body 부분은 지침의 주요 부분을 나타냅니다.

다음 섹션에서는 SPEC 파일의 각 섹션에 대해 설명합니다.

4.2.1. 사전 항목

아래 표는 RPM SPEC 파일의 Preamble 섹션에서 자주 사용되는 몇 가지 지시문을 제공합니다.

표 4.1. RPM SPEC 파일의 Preamble 섹션에 사용된 항목

SPEC 조건	정의
`이름`	SPEC 파일 이름과 일치해야 하는 패키지의 기본 이름입니다.
`버전`	소프트웨어의 업스트림 버전 번호입니다.
`릴리스 버전`	이 버전의 소프트웨어가 릴리스된 횟수입니다. 일반적으로 초기 값을 1%{?dist}로 설정하고 패키지의 새 릴리스마다 증가시킵니다. 새 `버전` 의 소프트웨어가 빌드되면 1로 재설정합니다.
`요약`	패키지에 대한 간략한 요약입니다.
`라이센스`	패키지하는 소프트웨어의 라이센스입니다.
`URL`	프로그램에 대한 자세한 내용은 전체 URL입니다. 대부분의 경우 이것은 패키지하는 소프트웨어의 업스트림 프로젝트 웹 사이트입니다.
`Source0`	업스트림 소스 코드의 압축 아카이브 경로 또는 URL(패치되지 않은 패치는 다른 위치에서 처리됩니다). 이는 아카이브의 액세스 가능하고 안정적인 스토리지(예: 패키지 관리자의 로컬 스토리지가 아닌 업스트림 페이지)를 가리켜야 합니다. 필요한 경우 더 많은 SourceX 지시문을 추가하여 매번 숫자를 늘릴 수 있습니다. 예를 들면 다음과 같습니다. Source1, Source2, Source3 등이 있습니다.
`패치`	필요한 경우 소스 코드에 적용할 첫 번째 패치의 이름입니다. 지시문은 두 가지 방법으로 적용할 수 있습니다. 패치 종료 시 또는 번호 없이 사용할 수 있습니다. 숫자를 지정하지 않으면 내부적으로 해당 항목에 할당됩니다. Patch0, Patch1, Patch2, Patch3 등을 사용하여 명시적으로 숫자를 지정할 수도 있습니다. 이러한 패치는 %patch0, %patch1, %patch2 매크로 등을 사용하여 하나씩 적용할 수 있습니다. 매크로는 RPM SPEC 파일의 body 섹션에 있는 %prep 지시문 내에 적용됩니다. 또는 %autopatch 매크로를 사용하면 SPEC 파일에 지정된 순서에 따라 모든 패치를 자동으로 적용할 수 있습니다.
`BuildArch`	패키지가 아키텍처에 의존하지 않는 경우 예를 들어 해석된 프로그래밍 언어로 전적으로 작성된 경우 이를 `BuildArch: noarch` 로 설정합니다. 설정되지 않은 경우 패키지는 빌드되는 시스템의 아키텍처(예: `x86_64` )를 자동으로 상속합니다.
`BuildRequires`	컴파일된 언어로 작성된 프로그램을 빌드하는 데 필요한 쉼표 또는 공백으로 구분된 패키지 목록입니다. `BuildRequires` 의 여러 항목이 있을 수 있으며, 각 항목은 SPEC 파일의 자체 행에 있습니다.
`필수 항목`	소프트웨어를 설치한 후 실행하는 데 필요한 쉼표 또는 공백으로 구분된 패키지 목록입니다. SPEC 파일의 자체 행에는 여러 개의 `Requires` 항목이 있을 수 있습니다.
`ExcludeArch`	특정 프로세서 아키텍처에서 소프트웨어가 작동할 수 없는 경우 여기에서 해당 아키텍처를 제외할 수 있습니다.
`충돌`	`conflicts` are inverse to `Requires`. `conflicts` 와 일치하는 패키지가 있는 경우 `Conflict` 태그가 이미 설치되어 있거나 설치할 패키지에 있는지 여부에 따라 패키지를 독립적으로 설치할 수 없습니다.
`사용되지 않음`	이 지시문은 `rpm` 명령이 명령줄에서 직접 사용되는지 또는 업데이트 또는 종속성 솔루션을 통해 수행하는지 여부에 따라 업데이트되는 방식을 변경합니다. 명령줄에서 사용하는 경우 RPM은 설치되지 않는 패키지의 오래된 패키지와 일치하는 모든 패키지를 제거합니다. 업데이트 또는 종속성 확인자를 사용하는 경우 일치하는 `Obsoletes:` 가 포함된 패키지가 업데이트로 추가되고 일치하는 패키지를 교체합니다.
`제공`	`Provides` 가 패키지에 추가되면 해당 이름이 아닌 종속성에서 패키지를 참조할 수 있습니다.If Provides is added to a package, the package can be referred to by dependencies other than its name.

Name,Version 및 Release 지시문은 RPM 패키지의 파일 이름을 구성합니다. RPM 패키지 파일 이름에 NAME-VERSION-RELEASE 형식이 있기 때문에 RPM 패키지 관리자 및 시스템 관리자는 이러한 세 개의 지시문 N-V-R 또는 NVR 을 호출하는 경우가 많습니다.

다음 예제에서는 rpm 명령을 쿼리하여 특정 패키지에 대한 NVR 정보를 가져오는 방법을 보여줍니다.

예 4.1. bash 패키지에 대한 NVR 정보를 제공하기 위해 rpm 쿼리

# rpm -q bash
bash-4.4.19-7.el8.x86_64

bash 는 패키지 이름이고 4.4.19 는 버전이며 7.el8 은 릴리스입니다. 최종 마커는 아키텍처에 신호를 보내는 x86_64 입니다. NVR 과 달리 아키텍처 마커는 RPM 패키지러를 직접 제어할 수 없지만 rpmbuild 빌드 환경에 의해 정의됩니다. 이에 대한 예외는 아키텍처 독립적인 noarch 패키지입니다.

4.2.2. 본문 항목

다음은 RPM SPEC 파일의 Body 섹션에 사용된 항목입니다.

표 4.2. RPM SPEC 파일의 body 섹션에서 사용되는 항목

SPEC 조건	정의
`%Description`	RPM에 패키지된 소프트웨어에 대한 전체 설명입니다. 이 설명은 여러 행에 걸쳐 있을 수 있으며 단락으로 나눌 수 있습니다.
`%Prep`	빌드할 소프트웨어를 준비하는 명령 또는 일련의 명령(예: `Source0` 에서 아카이브 압축을 풉니다. 이 지시문에는 쉘 스크립트가 포함될 수 있습니다.
`%build`	소프트웨어를 머신 코드(컴파일된 언어의 경우) 또는 바이트 코드(일부 해석 언어의 경우)로 빌드하는 명령 또는 일련의 명령입니다.
`%install`	`%builddir` 에서 원하는 빌드 아티팩트를 복사하는 명령 또는 일련의 명령(빌드가 발생하는 경우) `%buildroot` 디렉터리(패키지할 파일이 포함된 디렉터리 구조 포함)). 일반적으로 ~/rpmbuild/BUILD에서 `~/rpmbuild/BUILD ROOT` 로 파일을 복사하고 `~/rpmbuild/BUILDROOT` 에 필요한 디렉터리를 만듭니다. 이는 최종 사용자가 패키지를 설치하는 경우에는 패키지가 아닌 패키지를 생성할 때만 실행됩니다. 자세한 내용은 SPEC 파일 작업을 참조하십시오.
`%check`	소프트웨어를 테스트하기 위한 명령 또는 일련의 명령. 여기에는 일반적으로 단위 테스트와 같은 사항이 포함됩니다.
`%files`	최종 사용자의 시스템에 삽입될 파일 목록입니다.
`%changelog`	다른 `버전` 또는 `릴리스` 빌드 간 패키지에 발생한 변경 사항 레코드입니다.

4.2.3. 고급 항목

SPEC 파일에는 Scriptlets 또는 Trigger 와 같은 고급 항목도 포함될 수 있습니다.

이는 빌드 프로세스가 아닌 최종 사용자의 시스템에 설치 프로세스 중 다른 시점에서 적용됩니다.

4.3. BuildRoots

RPM 패키징 컨텍스트에서 buildroot 는 chroot 환경입니다. 빌드 아티팩트는 최종 사용자 시스템에서 향후 계층 구조와 동일한 파일 시스템 계층 구조를 사용하고 buildroot 는 루트 디렉터리 역할을 합니다. 빌드 아티팩트 배치는 최종 사용자 시스템의 파일 시스템 계층 구조 표준을 준수해야 합니다.

buildroot 의 파일은 나중에 RPM의 주요 부분이 되는 cpio 아카이브에 배치됩니다. RPM이 최종 사용자의 시스템에 설치되면 이러한 파일이 루트 디렉터리에 추출되어 올바른 계층 구조를 유지합니다.

참고

Red Hat Enterprise Linux 6부터는 rpmbuild 프로그램의 기본값이 있습니다. 이러한 기본값을 재정의하면 몇 가지 문제가 발생합니다. 따라서 이 매크로의 고유한 값을 정의하지 않는 것이 좋습니다. rpmbuild 디렉터리의 기본값과 함께 %{buildroot} 매크로를 사용할 수 있습니다.

4.4. RPM 매크로

rpm 매크로 는 특정 기본 제공 기능을 사용할 때 문의 선택적 평가를 기반으로 조건부로 할당할 수 있는 직간 텍스트 대체입니다. 따라서 RPM에서 텍스트 대체를 수행할 수 있습니다.

예제 사용은 SPEC 파일에서 패키지 소프트웨어 버전 을 여러 번 참조하는 것입니다. %{version} 매크로에서 한 번만 버전 을 정의하고 SPEC 파일 전체에서 이 매크로를 사용합니다. 모든 이벤트는 이전에 정의한 버전으로 자동 대체됩니다.

참고

익숙하지 않은 매크로가 표시되면 다음 명령을 사용하여 평가할 수 있습니다.

$ rpm --eval %{_MACRO}

%{_bindir} 및 %{_libexecdir} 매크로 평가

$ rpm --eval %{_bindir}
/usr/bin

$ rpm --eval %{_libexecdir}
/usr/libexec

일반적으로 사용되는 매크로 중 하나는 빌드에 사용되는 배포를 나타내는 %{?dist} 매크로입니다.

# On a RHEL 9.x machine
$ rpm --eval %{?dist}
.el8

4.5. SPEC 파일 작업

새 소프트웨어를 패키지하려면 SPEC 파일을 생성해야 합니다.

다음과 같은 방법으로 SPEC 파일을 생성할 수 있습니다.

새 SPEC 파일을 처음부터 수동으로 작성합니다.
rpmdev-newspec 유틸리티를 사용합니다.
이 유틸리티는 필요한 지시문 및 필드를 채우는 채워지지 않은 SPEC 파일을 생성합니다.

참고

일부 프로그래밍 중심 텍스트 편집기는 새 . spec 파일을 자체 SPEC 템플릿으로 미리 채웁니다. rpmdev-newspec 유틸리티는 편집기와 무관한 방법을 제공합니다.

다음 섹션에서는 Hello World! 프로그램의 세 가지 예제 구현을 사용합니다.

소프트웨어 이름	예제 설명
somethingamo	원시 해석된 프로그래밍 언어로 작성된 프로그램입니다. 소스 코드를 빌드할 필요가 없으며 설치할 필요가 있는 경우를 보여줍니다. 미리 컴파일된 바이너리를 패키징해야 하는 경우 바이너리도 파일이므로 이 방법을 사용할 수도 있습니다.
pello	바이트로 컴파일된 해석된 프로그래밍 언어로 작성된 프로그램입니다. 소스 코드를 바이트로 컴파일하고 바이트 코드를 설치하여 미리 최적화된 파일을 보여줍니다.
cello	기본적으로 컴파일된 프로그래밍 언어로 작성된 프로그램입니다. 소스 코드를 머신 코드로 컴파일하고 결과 실행 파일을 설치하는 일반적인 프로세스를 보여줍니다.

Hello World 의 구현은 다음과 같습니다.

bello-0.1.tar.gz

전제 조건으로 이러한 구현을 ~/rpmbuild/SOURCES 디렉토리에 배치해야 합니다.

Hello World! 프로그램 구현에 대한 자세한 내용은 소스 코드 의 내용을 참조하십시오.

다음 섹션에서는 SPEC 파일을 사용하는 방법을 알아봅니다.

rpmdev-newspec 을 사용하여 새 SPEC 파일을 만듭니다.
RPM 을 생성하기 위해 원래 SPEC 파일을 수정합니다.
bash,Python, C 로 작성된 프로그램에 대한 SPEC 파일 예제를 검사합니다.

4.5.1. rpmdev-newspec을 사용하여 새 SPEC 파일 만들기

rpmdev-newspec 유틸리티를 사용하여 Hello World! 프로그램의 세 가지 구현 각각에 대해 SPEC 파일을 만들려면 다음 단계를 완료하십시오.

절차

~/rpmbuild/SPECS 디렉터리로 이동하여 rpmdev-newspec 유틸리티를 사용합니다.
```
$ cd ~/rpmbuild/SPECS
```
Hello World의 세 가지 구현 각각에 대한 SPEC 파일을 만듭니다! rpmdev-newspec 유틸리티를 사용하여 프로그램:
```
$ rpmdev-newspec bello
bello.spec created; type minimal, rpm version >= 4.11.

$ rpmdev-newspec cello
cello.spec created; type minimal, rpm version >= 4.11.

$ rpmdev-newspec pello
pello.spec created; type minimal, rpm version >= 4.11.
```
~/rpmbuild/SPECS/ 디렉터리에는 이제 bello.spec,cello.spec 및 pello.spec 이라는 세 개의 SPEC 파일이 있습니다.
생성된 파일을 검사합니다.
파일의 지시문은 What is a SPEC file.에 설명된 내용을 나타냅니다. 다음 섹션에서는 rpmdev-newspec 의 출력 파일에 특정 섹션을 채웁니다.

참고

rpmdev-newspec 유틸리티는 특정 Linux 배포판과 관련된 지침이나 규칙을 사용하지 않습니다. 그러나 이 문서는 Red Hat Enterprise Linux를 대상으로 하므로 SPEC 파일 전체에서 정의되거나 제공된 다른 모든 매크로와 일관성을 위해 RPM의 Buildroot를 참조할 때 %{buildroot} 표기법이 우선합니다.

4.5.2. RPM을 생성하기 위해 원래 SPEC 파일 수정

RPM 패키지 생성을 위해 rpmdev-newspec 유틸리티에서 제공하는 SPEC 파일을 수정하려면 다음 단계를 완료하십시오.

사전 요구 사항

특정 프로그램의 소스 코드는 ~/rpmbuild/SOURCES/ 디렉토리에 배치되었습니다.
rpmdev-newspec 유틸리티에 의해 채워지지 않은 ~/rpmbuild/SPECS/<name>.spec SPEC 파일이 생성되었습니다.

절차

rpmdev-newspec 유틸리티에서 제공하는 ~/rpmbuild/SPECS/<name>.spec 파일의 출력 템플릿을 엽니다.
1. rpmdev-newspec 이 함께 그룹화된 다음 지시문을 포함하는 SPEC 파일의 첫 번째 섹션을 채웁니다.
  이름
  Name 은 rpmdev-newspec 에 대한 인수로 이미 지정되었습니다.
  버전
  소스 코드의 업스트림 릴리스 버전과 일치하도록 버전 을 설정합니다.
  릴리스 버전
  릴리스 가 자동으로 1%{?dist} 로 설정되어 있으며 이는 처음 1 입니다. 예를 들어 패치를 포함하는 경우 업스트림 릴리스 버전이 변경되지 않고 패키지를 업데이트할 때마다 초기 값을 늘립니다. 새 업스트림 릴리스 가 발생하면 릴리스를 1 로 재설정합니다.
  요약
  요약 은 이 소프트웨어가 무엇인지에 대한 간단한 한 줄 설명입니다.
2. 라이센스,URL 및 Source0 지시문을 채웁니다.
  라이센스
  라이센스 필드는 업스트림 릴리스의 소스 코드와 관련된 소프트웨어 라이센스입니다. SPEC 파일의 라이센스 레이블을 지정하는 방법에 대한 정확한 형식은 다음 RPM 기반 Linux 배포 지침에 따라 다릅니다.
  예를 들어, RuntimeClassv 3+를 사용할 수 있습니다.
  URL
  URL 필드는 업스트림 소프트웨어 웹 사이트에 URL을 제공합니다. 일관성을 위해 %{name} 의 RPM 매크로 변수를 사용하고 https://example.com/%{name} 을 사용합니다.
  소스
  Source0 필드는 업스트림 소프트웨어 소스 코드에 URL을 제공합니다. 패키지화 중인 특정 버전의 소프트웨어에 직접 연결해야 합니다. 이 문서에 제공된 예제 URL에는 향후 변경될 수 있는 하드 코딩된 값이 포함되어 있습니다. 마찬가지로 릴리스 버전도 변경될 수 있습니다. 잠재적인 변경 사항을 단순화하려면 %{name} 및 %{version} 매크로를 사용합니다. 이를 사용하여 SPEC 파일에서 하나의 필드만 업데이트해야 합니다.
3. BuildRequires,Requires 및 BuildArch 지시문을 채웁니다.
  BuildRequires
  BuildRequires 는 패키지에 대한 빌드 타임 종속성을 지정합니다.
  필수 항목
  패키지에 대한 런타임 종속 항목을 지정합니다.
  BuildArch
  이는 기본적으로 컴파일된 확장 기능 없이 해석된 프로그래밍 언어로 작성된 소프트웨어입니다. 따라서 noarch 값을 사용하여 BuildArch 지시문을 추가합니다. 이는 이 패키지가 빌드된 프로세서 아키텍처에 바인딩되지 않아도 된다고 RPM에 지시합니다.
4. %description,%prep,%build,%install,%files, %license 지시문을 채웁니다. 이러한 지시문은 여러 줄, 다중 설명 또는 스크립팅된 작업을 수행할 수 있는 지시문이므로 섹션 제목으로 생각할 수 있습니다.
  %Description
  %description 은 요약 보다 소프트웨어에 대한 더 긴 전체 설명입니다. 이 지시문에는 하나 이상의 단락이 포함되어 있습니다.
  %Prep
  %prep 섹션에서는 빌드 환경을 준비하는 방법을 지정합니다. 일반적으로 소스 코드의 압축 아카이브, 패치 적용 및, SPEC 파일의 이후 부분에서 사용하기 위해 소스 코드에 제공된 정보 구문 분석과 관련이 있습니다. 이 섹션에서는 내장 %setup -q 매크로를 사용할 수 있습니다.
  %build
  %build 섹션은 소프트웨어를 빌드하는 방법을 지정합니다.
  %install
  %install 섹션에는 BUILDROOT 디렉터리에 소프트웨어 설치 방법에 대한 지침이 포함되어 있습니다.
  이 디렉터리는 최종 사용자의 root 디렉터리와 유사한 빈 chroot 기본 디렉터리입니다. 여기에서 설치된 파일을 포함할 디렉토리를 만들 수 있습니다. 이러한 디렉터리를 생성하려면 경로를 하드 코딩하지 않고도 RPM 매크로를 사용할 수 있습니다.
  %files
  %files 섹션은 이 RPM에서 제공하는 파일 목록과 최종 사용자의 시스템에서 전체 경로 위치를 지정합니다.
  이 섹션에서는 내장 매크로를 사용하여 다양한 파일의 역할을 나타낼 수 있습니다. rpm 명령을 사용하여 패키지 파일 매니페스트 메타데이터를 쿼리하는 데 유용합니다. 예를 들어 LICENSE 파일이 소프트웨어 라이센스 파일임을 나타내기 위해 %license 매크로를 사용합니다.
5. 마지막 섹션인 %changelog 는 패키지의 각 버전-Release에 대해 오염된 날짜 목록입니다. 소프트웨어 변경 사항이 아닌 패키징 변경 사항을 기록합니다. 패키징 변경의 예: %build 섹션에서 패치 추가, 빌드 절차를 변경합니다.
  * 문자가 있는 %changelog 섹션의 첫 번째 줄을 시작하고 그 뒤에 Day-of-Week Day Name Surname <email> - Version-Release 를 시작합니다.
  실제 변경 항목은 다음 규칙을 따릅니다.
  - 각 변경 항목에는 각 변경 사항에 대해 하나씩 여러 항목이 포함될 수 있습니다.
  - 각 항목은 새 줄에서 시작됩니다.
  - 각 항목은 - 문자로 시작합니다.

이제 필요한 프로그램에 대한 전체 SPEC 파일을 작성했습니다.

추가 리소스

bash로 작성된 프로그램의 SPEC 파일의 예
Python으로 작성된 프로그램의 SPEC 파일의 예
C로 작성된 프로그램에 대한 SPEC 파일의 예
RPM 빌드

4.5.3. bash로 작성된 프로그램의 SPEC 파일 예제

참조를 위해 bash로 작성된 벨로 프로그램에 다음 예제 SPEC 파일을 사용할 수 있습니다.

bash로 작성된 bello 프로그램의 SPEC 파일 예제

Name:           bello
Version:        0.1
Release:        1%{?dist}
Summary:        Hello World example implemented in bash script

License:        GPLv3+
URL:            https://www.example.com/%{name}
Source0:        https://www.example.com/%{name}/releases/%{name}-%{version}.tar.gz

Requires:       bash

BuildArch:      noarch

%description
The long-tail description for our Hello World Example implemented in
bash script.

%prep
%setup -q

%build

%install

mkdir -p %{buildroot}/%{_bindir}

install -m 0755 %{name} %{buildroot}/%{_bindir}/%{name}

%files
%license LICENSE
%{_bindir}/%{name}

%changelog
* Tue May 31 2016 Adam Miller <maxamillion@fedoraproject.org> - 0.1-1
- First bello package
- Example second item in the changelog for version-release 0.1-1

패키지에 대한 빌드 시간 종속성을 지정하는 BuildRequires 지시문이 bello 빌드 단계가 없기 때문에 삭제되었습니다. Bash는 원시 해석된 프로그래밍 언어이며 파일은 시스템의 위치에만 설치됩니다.
bello 스크립트에는 bash 쉘 환경만 필요하므로 패키지에 대한 런타임 종속성을 지정하는 Requires 지시문은 bash 만 포함합니다.
소프트웨어 빌드 방법을 지정하는 %build 섹션은 bash 를 빌드할 필요가 없으므로 비어 있습니다.

참고

bello 를 설치하려면 대상 디렉터리를 만들고 실행 가능한 bash 스크립트 파일만 설치해야 합니다. 따라서 %install 섹션에서 install 명령을 사용할 수 있습니다. RPM 매크로를 사용하여 하드 코딩 경로 없이 이 작업을 수행할 수 있습니다.

추가 리소스

소스 코드란

4.5.4. Python으로 작성된 프로그램의 SPEC 파일 예제

Python 프로그래밍 언어로 작성된 pello 프로그램에 대한 SPEC 파일은 다음과 같습니다.

Python으로 작성된 pello 프로그램의 SPEC 파일의 예

%global python3_pkgversion 3.11                                       1

Name:           python-pello                                          2
Version:        1.0.2
Release:        1%{?dist}
Summary:        Example Python library

License:        MIT
URL:            https://github.com/fedora-python/Pello
Source:         %{url}/archive/v%{version}/Pello-%{version}.tar.gz

BuildArch:      noarch
BuildRequires:  python%{python3_pkgversion}-devel                     3

# Build dependencies needed to be specified manually
BuildRequires:  python%{python3_pkgversion}-setuptools

# Test dependencies needed to be specified manually
# Also runtime dependencies need to be BuildRequired manually to run tests during build
BuildRequires:  python%{python3_pkgversion}-pytest >= 3


%global _description %{expand:
Pello is an example package with an executable that prints Hello World! on the command line.}

%description %_description

%package -n python%{python3_pkgversion}-pello                         4
Summary:        %{summary}

%description -n python%{python3_pkgversion}-pello %_description


%prep
%autosetup -p1 -n Pello-%{version}


%build
# The macro only supported projects with setup.py
%py3_build                                                            5


%install
# The macro only supported projects with setup.py
%py3_install


%check                                                                6
%{pytest}


# Note that there is no %%files section for the unversioned python module
%files -n python%{python3_pkgversion}-pello
%doc README.md
%license LICENSE.txt
%{_bindir}/pello_greeting

# The library files needed to be listed manually
%{python3_sitelib}/pello/

# The metadata files needed to be listed manually
%{python3_sitelib}/Pello-*.egg-info/

1: python3_pkgversion 매크로를 정의하면 이 패키지가 빌드할 Python 버전을 설정합니다. 기본 Python 버전 3.9를 빌드하려면 매크로를 기본값 3 으로 설정하거나 행을 완전히 제거합니다.
2: Python 프로젝트를 RPM에 패키징할 때 항상 프로젝트의 원래 이름에 python- 접두사를 추가합니다. 원래 이름은 pello 이므로 Source RPM (SRPM)의 이름은 python-pello 입니다.
3: BuildRequires 는 이 패키지를 빌드하고 테스트하는 데 필요한 패키지를 지정합니다. BuildRequires 에서는 항상 python3-devel (또는 python3.11-devel)과 패키지하는 특정 소프트웨어에 필요한 관련 프로젝트 (예: python3-setuptools (또는 python3.11-setuptools) 또는 %check 섹션에서 테스트를 실행하는 데 필요한 런타임 및 테스트 종속성과 같은 Python 패키지 빌드에 필요한 툴을 제공하는 항목을 포함합니다.
4: 바이너리 RPM의 이름(사용자가 설치할 수 있는 패키지)을 선택할 때 버전 지정된 Python 접두사를 추가합니다. 기본 Python 3.9에는 python3- 접두사 또는 Python 3.11의 경우 python3.11- 접두사를 사용합니다. %{python3_pkgversion} 매크로를 사용할 수 있습니다. 이 매크로는 명시적 버전(예: 3.11 참조)으로 설정하지 않는 한 기본 Python 버전 3.9에 대해 3 으로 평가됩니다.
5: %py3_build 및 %py3_install 매크로는 각각 setup.py build 및 setup.py install 명령을 실행하여 설치 위치, 사용할 인터프리터를 지정하는 추가 인수와 함께 실행합니다.
6: %check 섹션에서는 패키지 프로젝트의 테스트를 실행해야 합니다. 정확한 명령은 프로젝트 자체에 따라 달라지지만 %pytest 매크로를 사용하여 RPM 친화적인 방식으로 pytest 명령을 실행할 수 있습니다.

4.5.5. C로 작성된 프로그램의 SPEC 파일 예제

참조용으로 C 프로그래밍 언어로 작성된 셀 오 프로그램에 대해 다음 예제 SPEC 파일을 사용할 수 있습니다.

C로 작성된 셀오 프로그램의 SPEC 파일 예제

Name:           cello
Version:        1.0
Release:        1%{?dist}
Summary:        Hello World example implemented in C

License:        GPLv3+
URL:            https://www.example.com/%{name}
Source0:        https://www.example.com/%{name}/releases/%{name}-%{version}.tar.gz

Patch0:         cello-output-first-patch.patch

BuildRequires:  gcc
BuildRequires:  make

%description
The long-tail description for our Hello World Example implemented in
C.

%prep
%setup -q

%patch0

%build
make %{?_smp_mflags}

%install
%make_install

%files
%license LICENSE
%{_bindir}/%{name}

%changelog
* Tue May 31 2016 Adam Miller <maxamillion@fedoraproject.org> - 1.0-1
- First cello package

패키지에 대한 빌드 시간 종속성을 지정하는 BuildRequires 지시문에는 컴파일 빌드 프로세스를 수행하는 데 필요한 두 개의 패키지가 포함되어 있습니다.
- gcc 패키지
- make 패키지
패키지에 대한 런타임 종속성을 지정하는 Requires 지시문은 이 예에서 생략됩니다. 모든 런타임 요구 사항은 rpmbuild 에 의해 처리되며 cello 프로그램에는 코어 C 표준 라이브러리 외부에 아무것도 필요하지 않습니다.
%build 섹션은 이 예제에서 cello 프로그램에 대한 Makefile 이 작성되었으므로 rpmdev-newspec 유틸리티에서 제공하는 GNU make 명령을 사용할 수 있다는 사실을 반영합니다. 그러나 구성 스크립트를 제공하지 않았기 때문에 %configure 호출을 제거해야 합니다.

rpmdev-newspec 명령에서 제공하는 %make_install 매크로를 사용하여 cello 프로그램을 설치할 수 있습니다. 이는 셀러 프로그램에 대한 Makefile 이 사용 가능하기 때문에 가능합니다.

추가 리소스

소스 코드란

4.6. RPM 빌드

rpmbuild 명령을 사용하여 RPM 패키지를 빌드할 수 있습니다. 이 명령을 실행하면 특정 디렉터리와 파일 구조가 rpmdev-setuptree 유틸리티로 설정된 구조와 동일합니다.

다른 사용 사례와 원하는 결과에는 rpmbuild 명령에 다양한 인수 조합이 필요합니다. 두 가지 주요 사용 사례는 다음과 같습니다.

소스 RPM 빌드
바이너리 RPM 빌드
- 소스 RPM에서 바이너리 RPM 재빌드
- SPEC 파일에서 바이너리 RPM 빌드
- 소스 RPM에서 바이너리 RPM 빌드

다음 섹션에서는 프로그램에 대한 SPEC 파일을 만든 후 RPM을 빌드하는 방법을 알아봅니다.

빌드 소스 RPM.
소스 RPM에서 바이너리 RPM을 다시 빌드합니다.
SPEC 파일에서 바이너리 RPM을 빌드 합니다.
소스 RPM에서 바이너리 RPM을 빌드합니다.

4.6.1. 소스 RPM 빌드

소스 RPM을 빌드하려면 다음 단계를 완료합니다.

사전 요구 사항

패키지하려는 프로그램의 SPEC 파일이 이미 있어야 합니다.

절차

지정된 SPEC 파일을 사용하여 rpmbuild 명령을 실행합니다.
```
$ rpmbuild -bs specfile
```
specfile 을 SPEC 파일의 이름으로 바꿉니다. b s 옵션은 빌드 소스를 나타냅니다.

검증 단계

rpmbuild/SRPMS 디렉터리에 결과 소스 RPM이 포함되어 있는지 확인합니다. 디렉터리는 rpmbuild 에서 예상되는 구조의 일부입니다.

예 4.2. bello, pello 및 cello를 위한 소스 RPM 구축.

다음은 벨로,pello 및 셀오 프로젝트에 대한 소스 RPM 빌드의 예입니다.

생성된 SPEC 파일이 포함된 ~/rpmbuild/SPECS/ 지시문으로 이동합니다.
```
$ cd ~/rpmbuild/SPECS/
```

지정된 SPEC 파일을 사용하여 rpmbuild 명령을 실행합니다.

$ rpmbuild -bs bello.spec
Wrote: /home/admiller/rpmbuild/SRPMS/bello-0.1-1.el8.src.rpm

$ rpmbuild -bs pello.spec
Wrote: /home/admiller/rpmbuild/SRPMS/pello-0.1.2-1.el8.src.rpm

$ rpmbuild -bs cello.spec
Wrote: /home/admiller/rpmbuild/SRPMS/cello-1.0-1.el8.src.rpm

추가 리소스

SPEC 파일 작업
rpmdev-newspec을 사용하여 새 SPEC 파일 생성
RPM을 생성하기 위한 원래 SPEC 파일 수정

4.6.2. 소스 RPM에서 바이너리 RPM 재빌드

소스 RPM(SRPM)에서 바이너리 RPM을 다시 빌드하려면 다음 단계를 완료합니다.

절차

SRPMs에서 bello,pello, cello 를 다시 빌드하려면 다음을 실행합니다.

$ rpmbuild --rebuild ~/rpmbuild/SRPMS/bello-0.1-1.el8.src.rpm
[output truncated]

$ rpmbuild --rebuild ~/rpmbuild/SRPMS/pello-0.1.2-1.el8.src.rpm
[output truncated]

$ rpmbuild --rebuild ~/rpmbuild/SRPMS/cello-1.0-1.el8.src.rpm
[output truncated]

참고

rpmbuild --rebuild 를 호출하면 다음이 포함됩니다.

SRPM(SPEC 파일 및 소스 코드)의 내용을 ~/rpmbuild/ 디렉터리에 설치합니다.
설치된 콘텐츠를 사용하여 RPM 빌드.
SPEC 파일 및 소스 코드 제거.

빌드 후 SPEC 파일과 소스 코드를 유지하려면 다음 단계 중 하나를 완료하십시오.

RPM을 빌드할 때 --rebuild 옵션 대신 --recompile 옵션과 함께 rpmbuild 명령을 사용합니다.

벨로 ,pello , 셀오용 SRPM을 설치합니다.

$ rpm -Uvh ~/rpmbuild/SRPMS/bello-0.1-1.el8.src.rpm
Updating / installing…
   1:bello-0.1-1.el8               [100%]

$ rpm -Uvh ~/rpmbuild/SRPMS/pello-0.1.2-1.el8.src.rpm
Updating / installing…
…1:pello-0.1.2-1.el8              [100%]

$ rpm -Uvh ~/rpmbuild/SRPMS/cello-1.0-1.el8.src.rpm
Updating / installing…
…1:cello-1.0-1.el8            [100%]

바이너리 RPM을 생성할 때 생성된 출력은 자세한 정보이며 디버깅에 유용합니다. 출력은 다양한 예제에 따라 다르며 SPEC 파일에 해당합니다.

생성된 바이너리 RPM은 ~/rpmbuild/RPMS/ YOURARCH 디렉터리에 있습니다. 여기서 packages는 아키텍처 또는 ~/rpmbuild/RPMS/noarch/ 디렉터리에 있습니다.

4.6.3. SPEC 파일에서 바이너리 RPM 빌드

SPEC 파일에서 벨로,pello 및 셀로 바이너리 RPM을 빌드하려면 다음 단계를 완료합니다.

절차

bb 옵션을 사용하여 rpmbuild 명령을 실행합니다.

$ rpmbuild -bb ~/rpmbuild/SPECS/bello.spec

$ rpmbuild -bb ~/rpmbuild/SPECS/pello.spec

$ rpmbuild -bb ~/rpmbuild/SPECS/cello.spec

4.6.4. 소스 RPM에서 바이너리 RPM 빌드

소스 RPM에서 모든 종류의 RPM을 빌드합니다. 이렇게 하려면 다음 단계를 완료합니다.

절차

다음 옵션 중 하나와 소스 패키지가 지정된 상태에서 rpmbuild 명령을 실행합니다.
```
# rpmbuild {-ra|-rb|-rp|-rc|-ri|-rl|-rs} [rpmbuild-options] source-package
```
source-package 를 소스 RPM의 이름으로 교체합니다.

추가 리소스

rpmbuild(8) 도움말 페이지

4.7. RPM에서 온전성 확인

패키지를 생성한 후 패키지의 품질을 확인해야 합니다.

패키지 품질을 확인하는 주요 도구는 rpmlint 입니다.

rpmlint 도구는 다음을 수행합니다.

RPM 유지 관리 기능 개선
RPM의 정적 분석을 수행하여 온전성 검사를 활성화합니다.
RPM의 정적 분석을 수행하여 오류 검사를 활성화합니다.

rpmlint 툴은 바이너리 RPM, 소스 RPM(SRPM) 및 SPEC 파일을 확인할 수 있습니다. 따라서 이 도구는 패키징의 모든 단계에 유용합니다.

rpmlint 에는 엄격한 지침이 있습니다. 따라서 다음 예와 같이 일부 오류 및 경고를 건너뛸 수 있는 경우가 있습니다.

참고

다음 섹션에 설명된 예에서 rpmlint 는 검증되지 않은 출력을 생성하는 옵션 없이 실행됩니다. 각 오류 또는 경고에 대한 자세한 설명은 대신 rpmlint -i 를 실행합니다.

4.7.1. Sanity에 대한 벨로오 확인

다음 섹션에서 bello SPEC 파일 및 bello 바이너리 RPM의 예에서 RPM에서 정상성을 확인할 때 발생할 수 있는 경고 및 오류를 조사합니다.

4.7.1.1. bello SPEC File for sanity 확인

다음 예제의 출력을 검사하여 광도에 대해 벨로보 SPEC 파일을 확인하는 방법을 알아봅니다.

예 4.3. bello에 대한 SPEC 파일에서 rpmlint 명령을 실행하는 출력

다음은 벨로 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 에서는 하나의 경고만 있습니다. invalid-url Source0 경고는 Source0 지시문에 나열된 URL에 연결할 수 없음을 의미합니다. 지정된 example.com URL이 없기 때문에 이는 예상되는 것입니다. 이 URL이 나중에 유효하다고 가정하면 이 경고를 무시할 수 있습니다.

예 4.4. 벨노용 SRPM에서 rpmlint 명령을 실행하는 출력

다음은 SRPM(벨로 소스 RPM)에서 실행되는 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. 벨로 바이너리 RPM에서 온전성을 확인

바이너리 RPM을 확인할 때 rpmlint 명령은 다음 항목을 확인합니다.

문서
도움말 페이지
파일 시스템 계층 구조 표준을 일관되게 사용

다음 예제의 출력을 검사하여 벨로 바이너리 RPM이 정상인지 확인하는 방법을 알아봅니다.

예 4.5. 벨노용 바이너리 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 경고는 다음을 제공하지 않았기 때문에 RPM에 문서 또는 수동 페이지가 없음을 의미합니다. 출력 경고 외에도 RPM은 rpmlint 검사를 전달했습니다.

4.7.2. 장로에서 장난을 확인

다음 섹션에서 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.com URL이 없기 때문에 이 작업이 예상됩니다. 이 URL이 나중에 유효하다고 가정하면 이 경고를 무시할 수 있습니다.

hardcoded-ctlplane-path 오류는 라이브러리 경로를 하드 코딩하는 대신 %{_libdir} 매크로를 사용하는 것이 좋습니다. 이 예제에서는 이러한 오류를 무시해도 됩니다. 그러나 프로덕션 환경으로 들어오는 패키지의 경우 모든 오류를 주의 깊게 확인합니다.

예 4.7. SRPM for pello에서 rpmlint 명령 실행의 출력

다음은 SRPM(Source RPM)에서 실행되는 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 명령은 다음 항목을 확인합니다.

문서
도움말 페이지
파일 시스템 계층 구조 표준을 일관되게 사용

다음 예제의 출력을 검사하여 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 경고는 다음을 제공하지 않았기 때문에 RPM에 문서 또는 수동 페이지가 없음을 의미합니다.
only-binary-in-usr-lib 경고는 /usr/lib/ 디렉터리에 바이너리가 아닌 아티팩트만 제공했음을 의미합니다. 이 디렉터리는 일반적으로 바이너리 파일인 공유 오브젝트 파일용으로 예약되어 있습니다. 따라서 rpmlint 는 /usr/lib/ 에 있는 하나 이상의 파일이 바이너리가 될 것으로 예상합니다.
다음은 Filesystem Hierarchy Standard의 준수를 확인하는 rpmlint 검사의 예입니다. 일반적으로 RPM 매크로를 사용하여 파일의 올바른 배치를 확인합니다. 이 예제에서는 이 경고를 무시해도 됩니다.
non-executable-script 오류는 /usr/lib/pello/pello.py 파일에 실행 권한이 없음을 의미합니다. rpmlint 툴에서는 파일에 hebang이 포함되어 있기 때문에 파일을 실행할 수 있어야 합니다. 이 예제의 목적을 위해 권한을 실행하지 않고 이 파일을 그대로 두고 이 오류를 무시할 수 있습니다.

출력 경고 및 오류 외에도 RPM은 rpmlint 검사를 통과했습니다.

4.7.3. Sanity에 대한 셀러 확인

다음 섹션에서는 셀오 SPEC 파일 및 셀오 바이너리 RPM의 예에서 RPM을 확인할 때 발생할 수 있는 경고 및 오류를 조사합니다.

4.7.3.1. 셀오 SPEC 파일에서 온전성 확인

다음 예제의 출력을 검사하여 셀오 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 의 경우 하나의 경고만 있습니다. 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. 셀로 바이너리 RPM에서 온전성 확인

바이너리 RPM을 확인할 때 rpmlint 명령은 다음 항목을 확인합니다.

문서
도움말 페이지
파일 시스템 계층 구조 표준을 일관되게 사용

다음 예제의 출력을 검사하여 셀로 바이너리 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 경고는 다음을 제공하지 않았기 때문에 RPM에 문서 또는 수동 페이지가 없음을 의미합니다.

출력 경고 외에도 RPM은 rpmlint 검사를 전달했습니다.

4.8. syslog에 RPM 활동 기록

RPM 활동 또는 트랜잭션은 시스템 로깅 프로토콜(syslog)에서 로깅할 수 있습니다.

사전 요구 사항

syslog 플러그인은 시스템에 설치됩니다.
```
# dnf install rpm-plugin-syslog
```
참고
syslog 메시지의 기본 위치는 /var/log/inspector 파일입니다. 그러나 메시지를 저장하는 다른 위치를 사용하도록 syslog를 구성할 수 있습니다.

RPM 활동에 대한 업데이트를 보려면 다음 단계를 완료합니다.

절차

syslog 메시지를 저장하도록 구성한 파일을 열거나 기본 syslog 구성을 사용하는 경우 /var/log/message 파일을 엽니다.
[RPM] 문자열을 포함하여 새 행을 검색합니다.

4.9. RPM 콘텐츠 추출

특히 RPM에 필요한 패키지가 손상된 경우 패키지의 콘텐츠를 추출해야 합니다. 이러한 경우 RPM 설치가 손상에도 불구하고 여전히 작동하는 경우 rpm2archive 유틸리티를 사용하여 .rpm 파일을 tar 아카이브로 변환하여 패키지 내용을 사용할 수 있습니다.

참고

RPM 설치가 심각한 경우 rpm2cpio 유틸리티를 사용하여 RPM 패키지 파일을 cpio 아카이브로 변환할 수 있습니다.

rpm2archive 유틸리티를 사용하여 RPM 페이로드를 tar 아카이브로 변환하려면 다음 단계를 완료합니다.

절차

RPM 파일에서 rpm2archive 명령을 실행합니다.
```
$ rpm2archive filename.rpm
```
filename 을 .rpm 파일의 이름으로 바꿉니다.
결과 파일에는 . tgz 접미사 가 있습니다. 예를 들어 bash 패키지를 아카이브하려면 다음을 수행합니다.
```
$ rpm2archive bash-4.4.19-6.el8.x86_64.rpm
$ bash-4.4.19-6.el8.x86_64.rpm.tgz
bash-4.4.19-6.el8.x86_64.rpm.tgz
```

5장. 고급 주제

이 섹션에서는 소개 튜토리얼의 범위를 벗어나지만 실제적인 RPM 패키지에 유용한 주제를 다룹니다.

5.1. RPM 패키지 서명

RPM 패키지에 서명하여 타사가 콘텐츠를 변경할 수 없도록 할 수 있습니다. 추가 보안 계층을 추가하려면 패키지를 다운로드할 때 HTTPS 프로토콜을 사용합니다.

rpm-sign 패키지에서 제공하는 --addsign 옵션을 사용하여 패키지에 서명할 수 있습니다.

사전 요구 사항

GPG 키 생성에 설명된 대로 GPG(GG) 키를 생성했습니다.

5.1.1. GPG 키 생성

다음 절차에 따라 패키지에 서명하는 데 필요한 GNU 개인 정보 보호 보호 (GPG) 키를 만듭니다.

절차

GPG 키 쌍을 생성합니다.
```
# gpg --gen-key
```
생성된 키 쌍을 확인합니다.
```
# gpg --list-keys
```
공개 키를 내보냅니다.
```
# gpg --export -a '<Key_name>' > RPM-GPG-KEY-pmanager
```
<Key_name>을 선택한 실제 키 이름으로 바꿉니다.
내보낸 공개 키를 RPM 데이터베이스로 가져옵니다.
```
# rpm --import RPM-GPG-KEY-pmanager
```

5.1.2. 패키지에 서명하도록 RPM 구성

RPM 패키지에 서명하려면 %_gpg_name RPM 매크로를 지정해야 합니다.

다음 절차에서는 패키지에 서명하기 위해 RPM을 구성하는 방법을 설명합니다.

절차

$HOME/.rpmmacros 파일에서 %_gpg_name 매크로를 다음과 같이 정의합니다.
```
%_gpg_name Key ID
```
키 ID 를 패키지에 서명하는 데 사용할 GNU GPG(GPG) 키 ID로 바꿉니다. 유효한 GPG 키 ID 값은 키를 생성한 사용자의 전체 이름 또는 이메일 주소입니다.

5.1.3. RPM 패키지에 서명 추가

가장 일반적인 경우는 서명 없이 패키지를 빌드하는 경우입니다. 서명은 패키지를 릴리스하기 직전에 추가됩니다.

RPM 패키지에 서명을 추가하려면 rpm-sign 패키지에서 제공하는 --addsign 옵션을 사용합니다.

절차

패키지에 서명을 추가합니다.
```
$ rpm --addsign package-name.rpm
```
package-name 을 서명하려는 RPM 패키지의 이름으로 바꿉니다.
참고
서명의 시크릿 키 잠금을 해제하려면 암호를 입력해야 합니다.

5.2. 매크로에 대한 추가 정보

이 섹션에서는 선택한 내장 RPM 매크로에 대해 설명합니다. 이러한 매크로의 전체 목록은 RPM 설명서 를 참조하십시오.

5.2.1. 자체 매크로 정의

다음 섹션에서는 사용자 지정 매크로를 만드는 방법을 설명합니다.

절차

RPM SPEC 파일에 다음 행을 포함합니다.
```
%global <name>[(opts)] <body>
```

<body> 주변의 모든 공백이 제거됩니다. 이름은 영숫자로 구성될 수 있으며 문자 _ 문자는 3자 이상이어야 합니다. (opts) 필드를 포함하는 것은 선택 사항입니다.

간단한 매크로에는 (opts) 필드가 포함되어 있지 않습니다. 이 경우 재귀적 매크로 확장만 수행됩니다.
Parametrized 매크로에는 (opts) 필드가 포함되어 있습니다. 괄호 사이에 선택 문자열은 매크로 호출 시작 시 argc/argv 처리를 위해 getopt(3) 에 전달됩니다.

참고

이전 RPM SPEC 파일은 대신 %define <name> <body> 매크로 패턴을 사용합니다. %define 과 %global 매크로의 차이점은 다음과 같습니다.

%define 에는 지역 범위가 있습니다. 이는 SPEC 파일의 특정 부분에 적용됩니다. %define 매크로의 본문은 사용 시 확장 됩니다.
%global 에는 전역 범위가 있습니다. 이는 전체 SPEC 파일에 적용됩니다. %global 매크로의 본문은 정의 시간에 확장됩니다.

중요

매크로는 주석 처리된 경우에도 평가되거나 매크로의 이름이 SPEC 파일의 %changelog 섹션에 지정됩니다. 매크로를 주석 처리하려면 %% 를 사용합니다. 예: %%global.

추가 리소스

매크로 구문

5.2.2. %setup 매크로 사용

이 섹션에서는 %setup 매크로의 다양한 변형을 사용하여 소스 코드 tarball을 사용하여 패키지를 빌드하는 방법을 설명합니다. 매크로 변형을 결합할 수 있습니다. rpmbuild 출력은 %setup 매크로의 표준 동작을 보여줍니다. 각 단계가 시작될 때 매크로는 Executing(%…)을 출력합니다.) 는 아래 예와 같이 입니다.

예 5.1. %setup 매크로 출력 예

Executing(%prep): /bin/sh -e /var/tmp/rpm-tmp.DhddsG

쉘 출력은 set -x enabled로 설정됩니다. /var/tmp/rpm-tmp.DhddsG 의 내용을 보려면 rpmbuild 가 빌드 후 임시 파일을 삭제하므로 --debug 옵션을 사용합니다. 그러면 환경 변수 설정이 표시된 다음 예를 들면 다음과 같습니다.

cd '/builddir/build/BUILD'
rm -rf 'cello-1.0'
/usr/bin/gzip -dc '/builddir/build/SOURCES/cello-1.0.tar.gz' | /usr/bin/tar -xof -
STATUS=$?
if [ $STATUS -ne 0 ]; then
  exit $STATUS
fi
cd 'cello-1.0'
/usr/bin/chmod -Rf a+rX,u+w,g-w,o-w .

%setup 매크로:

올바른 디렉터리에서 작동하는지 확인합니다.
이전 빌드의 남은 부분을 제거합니다.
소스 tarball의 압축을 풉니다.
몇 가지 기본 권한을 설정합니다.

5.2.2.1. %setup -q 매크로 사용

-q 옵션은 %setup 매크로의 상세 수준을 제한합니다. tar -xvvof 대신 tar -xof 만 실행됩니다. 첫 번째 옵션으로 이 옵션을 사용합니다.

5.2.2.2. %setup -n 매크로 사용

n 옵션은 확장된 tarball의 디렉터리 이름을 지정하는 데 사용됩니다.

이는 확장된 tarball의 디렉터리가 예상 것과 다른 이름(%{name}-%{version})과 다른 이름이 있어 %setup 매크로의 오류로 이어질 수 있는 경우에 사용됩니다.

예를 들어 패키지 이름이 cello 이지만 소스 코드가 hello-1.0.tgz 에 보관되고 hello/ 디렉터리가 포함된 경우 SPEC 파일 콘텐츠는 다음과 같아야 합니다.

Name: cello
Source0: https://example.com/%{name}/release/hello-%{version}.tar.gz
…
%prep
%setup -n hello

5.2.2.3. %setup -c 매크로 사용

소스 코드 tarball에 하위 디렉터리가 포함되어 있지 않고 압축을 푼 후 아카이브의 파일이 현재 디렉터리를 채우는 경우 -c 옵션이 사용됩니다.

그런 다음 -c 옵션은 다음과 같이 디렉터리 및 단계를 아카이브 확장에 생성합니다.

/usr/bin/mkdir -p cello-1.0
cd 'cello-1.0'

아카이브 확장 후에는 디렉터리가 변경되지 않습니다.

5.2.2.4. %setup -D 및 %setup -T 매크로 사용

-D 옵션은 소스 코드 디렉터리 삭제를 비활성화하고 %setup 매크로가 여러 번 사용되는 경우 특히 유용합니다. d 옵션을 사용하면 다음 행이 사용되지 않습니다.

rm -rf 'cello-1.0'

-T 옵션은 스크립트에서 다음 행을 제거하여 소스 코드 tarball 확장을 비활성화합니다.

/usr/bin/gzip -dc '/builddir/build/SOURCES/cello-1.0.tar.gz' | /usr/bin/tar -xvvof -

5.2.2.5. %setup -a 및 %setup -b 매크로 사용

a 및 - b 옵션은 특정 소스를 확장합니다.

b 옵션은 이전 을 나타냅니다. 이 옵션은 작업 디렉터리를 입력하기 전에 특정 소스를 확장합니다.
a 옵션은 이후 를 나타냅니다. 이 옵션은 입력 후 해당 소스를 확장합니다. 해당 인수는 SPEC 파일의 소스 번호입니다.

다음 예에서 cello-1.0.tar.gz 아카이브에는 빈 예제 디렉터리가 포함되어 있습니다. 예제는 별도의 examples.tar.gz tarball에 포함되어 있으며 동일한 이름의 디렉토리로 확장됩니다. 이 경우 작업 디렉터리를 입력한 후 Source1 을 확장하려면 -a 1 을 사용합니다.

Source0: https://example.com/%{name}/release/%{name}-%{version}.tar.gz
Source1: examples.tar.gz
…
%prep
%setup -a 1

다음 예에서 예제는 cello-1.0/examples 로 확장되는 별도의 cello-1.0-examples.tar.gz tarball에 제공되어 있습니다. 이 경우 작업 디렉터리를 입력하기 전에 -b 1 을 사용하여 Source1 을 확장합니다.

Source0: https://example.com/%{name}/release/%{name}-%{version}.tar.gz
Source1: %{name}-%{version}-examples.tar.gz
…
%prep
%setup -b 1

5.2.3. %files 섹션의 공통 RPM 매크로

다음 표에는 SPEC 파일의 %files 섹션에 필요한 고급 RPM 매크로가 나열되어 있습니다.

표 5.1. %files 섹션의 고급 RPM 매크로

macro	정의
% license	`%license` 매크로는 `LICENSE` 파일로 나열된 파일을 식별하고 RPM과 같이 설치 및 레이블이 지정됩니다. 예: `%license LICENSE`.
%doc	`%doc` 매크로는 문서로 나열된 파일을 식별하고 RPM에 따라 설치 및 레이블이 지정됩니다. %doc 매크로는 패키지 소프트웨어에 대한 문서와 코드 예제 및 다양한 관련 항목에도 사용됩니다. 코드 예제가 포함된 경우 파일에서 실행 모드를 제거하려면 주의해야 합니다. 예: `%doc README`
%dir	`%dir` 매크로는 경로가 이 RPM이 소유한 디렉터리인지 확인합니다. RPM 파일 매니페스트에서 설치 제거할 디렉토리를 정확하게 파악할 수 있도록 하는 것이 중요합니다. 예: `%dir %{_libdir}/%{name}`
%config(noreplace)	`%config(noreplace)` 매크로는 다음 파일이 구성 파일임을 확인하므로 원래 설치 체크섬에서 파일을 수정한 경우 패키지 설치 또는 업데이트에서 덮어쓰거나 교체해서는 안 됩니다. 변경 사항이 있는 경우 대상 시스템의 기존 또는 수정된 파일이 수정되지 않도록 업그레이드 또는 설치 시 파일 이름 끝에 `.rpmnew` 가 추가됩니다. 예: `%config(noreplace) %{_sysconfdir}/%{name}/%{name}.conf`

5.2.4. 내장 매크로 표시

Red Hat Enterprise Linux는 여러 개의 내장 RPM 매크로를 제공합니다.

절차

기본 제공 RPM 매크로를 모두 표시하려면 다음을 실행합니다.
```
rpm --showrc
```
참고
출력은 매우 크기 조정 가능합니다. 결과를 좁히려면 위의 명령을 grep 명령과 함께 사용합니다.
시스템 RPM 버전의 RPM에 대한 RPM에 대한 정보를 찾으려면 다음을 실행합니다.
```
rpm -ql rpm
```
참고
RPM 매크로는 출력 디렉토리 구조에서 매크로 라는 이름의 파일입니다.

5.2.5. RPM 배포 매크로

다른 배포에서는 패키지화된 소프트웨어의 언어 구현 또는 배포의 특정 지침에 따라 다양한 권장 RPM 매크로 세트를 제공합니다.

권장 RPM 매크로 세트는 종종 RPM 패키지로 제공되며 dnf 패키지 관리자를 사용하여 설치할 수 있습니다.

설치한 후 매크로 파일은 /usr/lib/rpm/macros.d/ 디렉토리에서 찾을 수 있습니다.

절차

원시 RPM 매크로 정의를 표시하려면 다음을 실행합니다.
```
rpm --showrc
```

위의 출력에는 원시 RPM 매크로 정의가 표시됩니다.

매크로가 수행하는 작업과 RPM을 패키징할 때 도움이 되는 방법을 확인하려면 인수로 사용되는 매크로 이름으로 rpm --eval 명령을 실행합니다.
```
rpm --eval %{_MACRO}
```

추가 리소스

RPM 도움말 페이지

5.2.6. 사용자 정의 매크로 생성

사용자 지정 매크로를 사용하여 ~/.rpmmacros 파일에서 배포 매크로를 재정의할 수 있습니다. 변경 사항은 시스템의 모든 빌드에 영향을 미칩니다.

주의

~/.rpmmacros 파일에서 새 매크로를 정의하는 것은 권장되지 않습니다. 이러한 매크로는 다른 시스템에는 존재하지 않으며, 사용자는 패키지를 다시 빌드하려고 할 수 있습니다.

절차

매크로를 재정의하려면 다음을 실행합니다.
```
%_topdir /opt/some/working/directory/rpmbuild
```

rpmdev-setuptree 유틸리티를 통해 모든 하위 디렉터리를 포함하여 위 예제에서 디렉터리를 생성할 수 있습니다. 이 매크로의 값은 기본적으로 ~/rpmbuild 입니다.

%_smp_mflags -l3

위의 매크로는 대부분 Makefile에 전달하는 데 사용됩니다(예: %{?_smp_mflags}, 빌드 단계에서 여러 개의 동시 프로세스 설정). 기본적으로 -jX 로 설정됩니다. 여기서 X 는 여러 코어입니다. 코어 수를 변경하면 패키지 빌드 속도를 높이거나 느려질 수 있습니다.

5.3. epoch, Scriptlets 및 Triggers

이 섹션에서는 RMP SPEC파일의 고급 지시문을 나타내는 스크립트릿, 트리거 및 트리거에 대해 설명합니다.

이러한 모든 지시문은 SPEC 파일뿐만 아니라 결과 RPM이 설치된 최종 시스템에도 영향을 미칩니다.

5.3.1. Epoch 지시문

Epoch 지시문을 사용하면 버전 번호에 따라 가중치 종속 항목을 정의할 수 있습니다.

이 지시문이 RPM SPEC 파일에 나열되지 않으면 Epoch 지시문이 전혀 설정되지 않습니다. 이는 Epoch를 설정하지 않으면 0의 Epoch 가 되는 일반적인 신뢰와 다릅니다. 그러나 dnf 유틸리티는 설정되지 않은 Epoch 를 분리하기 위해 0의 Epoch 와 동일하게 처리합니다.

그러나 SPEC 파일에 Epoch 를 나열하는 것은 일반적으로 생략됩니다. 대부분의 경우 패키지 버전을 비교할 때 Epoch 값이 예상되는 RPM 동작을 유발하기 때문입니다.

예 5.2. Epoch 사용

Epoch를 사용하여 foobar 패키지를 설치하는 경우: 1 및 Version: 1.0, 및 다른 사용자가 Version을 사용하여 foobar 를 패키징합니다. 2.0 하지만 Epoch 지시문이 없으면 새 버전이 업데이트되지 않습니다. Epoch 버전이 RPM 패키지에 대한 버전 관리를 나타내는 기존 Name-Version-Release 마커보다 우선하기 때문입니다.

따라서 Epoch 를 사용하는 것은 매우 드물다. 그러나 Epoch 는 일반적으로 업그레이드 순서 문제를 해결하는 데 사용됩니다. 이 문제는 인코딩에 따라 항상 안정적으로 비교할 수 없는 알파벳 문자를 포함하는 소프트웨어 버전 번호 체계 또는 버전의 업스트림 변경의 측면으로 나타날 수 있습니다.

5.3.2. scriptlets 지시문

scriptlets 는 패키지 설치 또는 삭제 전이나 후에 실행되는 일련의 RPM 지시문입니다.

빌드 시 또는 시작 스크립트에서 수행할 수 없는 작업에만 Scriptlets 를 사용합니다.

공통 scriptlet 지시문 세트가 있습니다. SPEC 파일 섹션 헤더(예: %build 또는 %install )와 유사합니다. 이는 종종 표준 POSIX 쉘 스크립트로 작성되는 코드의 여러 줄 세그먼트에 의해 정의됩니다. 그러나 대상 시스템의 배포를 위해 RPM이 허용하는 다른 프로그래밍 언어로도 작성할 수 있습니다. RPM 문서에는 사용 가능한 언어의 전체 목록이 포함되어 있습니다.

다음 표에는 실행 순서에 나열된 Scriptlet 지시문이 포함되어 있습니다. 스크립트가 포함된 패키지가 %pre 및 %post un 지시문 사이에 설치되고 %preun 과 %postun 지시문 사이에 제거됩니다.

표 5.2. Scriptlet 지시문

directive	정의
`%pretrans`	Scriptlet은 패키지를 설치하거나 제거하기 직전에 실행됩니다.
`%pre`	대상 시스템에 패키지를 설치하기 직전에 실행되는 Scriptlet입니다.
`%post`	대상 시스템에 패키지를 설치한 후에만 실행되는 Scriptlet입니다.
`%preun`	대상 시스템에서 패키지를 설치 제거하기 직전에 실행되는 Scriptlet입니다.
`%postun`	대상 시스템에서 패키지를 제거한 후에 실행되는 Scriptlet입니다.
`%posttrans`	트랜잭션 종료 시 실행되는 Scriptlet입니다.

5.3.3. scriptlet 실행 비활성화

다음 절차에서는 rpm 명령을 --no_scriptlet_name_ 옵션과 함께 사용하여 스크립트 파일의 실행을 끄는 방법을 설명합니다.

절차

예를 들어 %pretrans scriptlet의 실행을 끄려면 다음을 실행합니다.
```
# rpm --nopretrans
```
다음 모든 항목과 동일한 --noscripts 옵션을 사용할 수도 있습니다.
- --nopre
- --nopost
- --nopreun
- --nopostun
- --nopretrans
- --noposttrans

추가 리소스

RPM(8) 도움말 페이지.

5.3.4. scriptlets 매크로

Scriptlets 지시문도 RPM 매크로에서 작동합니다.

다음 예제에서는 systemd에 새 장치 파일에 대해 알림을 받는 systemd scriptlet 매크로를 사용하는 방법을 보여줍니다.

$ rpm --showrc | grep systemd
-14: __transaction_systemd_inhibit      %{__plugindir}/systemd_inhibit.so
-14: _journalcatalogdir /usr/lib/systemd/catalog
-14: _presetdir /usr/lib/systemd/system-preset
-14: _unitdir   /usr/lib/systemd/system
-14: _userunitdir       /usr/lib/systemd/user
/usr/lib/systemd/systemd-binfmt %{?*} >/dev/null 2>&1 || :
/usr/lib/systemd/systemd-sysctl %{?*} >/dev/null 2>&1 || :
-14: systemd_post
-14: systemd_postun
-14: systemd_postun_with_restart
-14: systemd_preun
-14: systemd_requires
Requires(post): systemd
Requires(preun): systemd
Requires(postun): systemd
-14: systemd_user_post  %systemd_post --user --global %{?*}
-14: systemd_user_postun        %{nil}
-14: systemd_user_postun_with_restart   %{nil}
-14: systemd_user_preun
systemd-sysusers %{?*} >/dev/null 2>&1 || :
echo %{?*} | systemd-sysusers - >/dev/null 2>&1 || :
systemd-tmpfiles --create %{?*} >/dev/null 2>&1 || :

$ rpm --eval %{systemd_post}

if [ $1 -eq 1 ] ; then
        # Initial installation
        systemctl preset  >/dev/null 2>&1 || :
fi

$ rpm --eval %{systemd_postun}

systemctl daemon-reload >/dev/null 2>&1 || :

$ rpm --eval %{systemd_preun}

if [ $1 -eq 0 ] ; then
        # Package removal, not upgrade
        systemctl --no-reload disable  > /dev/null 2>&1 || :
        systemctl stop  > /dev/null 2>&1 || :
fi

5.3.5. Triggers 지시문

Trigger 는 패키지 설치 및 제거 중에 상호 작용 방법을 제공하는 RPM 지시문입니다.

주의

트리거 는 예기치 않은 시간에 실행될 수 있습니다(예: 포함된 패키지의 업데이트). 트리거 는 디버그하기 어렵기 때문에 예기치 않게 실행될 때 아무 것도 손상시키지 않도록 강력한 방식으로 구현해야 합니다. 이러한 이유로 Red Hat은 트리거 사용을 최소화할 것을 권장합니다.

단일 패키지 업그레이드에 대한 실행 순서와 각 기존 트리거에 대한 세부 정보는 다음과 같습니다.

all-%pretrans
…
any-%triggerprein (%triggerprein from other packages set off by new install)
new-%triggerprein
new-%pre      for new version of package being installed
…           (all new files are installed)
new-%post     for new version of package being installed

any-%triggerin (%triggerin from other packages set off by new install)
new-%triggerin
old-%triggerun
any-%triggerun (%triggerun from other packages set off by old uninstall)

old-%preun    for old version of package being removed
…           (all old files are removed)
old-%postun   for old version of package being removed

old-%triggerpostun
any-%triggerpostun (%triggerpostun from other packages set off by old un
            install)
…
all-%posttrans

위의 항목은 /usr/share/doc/rpm-4.*/triggers 파일에서 찾을 수 있습니다.

5.3.6. SPEC 파일에서 쉘이 아닌 스크립트 사용

SPEC 파일의 -p scriptlet 옵션을 사용하면 사용자가 기본 쉘 스크립트 인터프리터(-p /bin/sh) 대신 특정 인터프리터를 호출할 수 있습니다.

다음 절차에서는 pello.py 프로그램 설치 후 메시지를 출력하는 스크립트를 생성하는 방법을 설명합니다.

절차

pello.spec 파일을 엽니다.

다음 행을 찾으십시오.

install -m 0644 %{name}.py* %{buildroot}/usr/lib/%{name}/

위 줄 아래에 다음을 삽입합니다.

%post -p /usr/bin/python3
print("This is {} code".format("python"))

RPM 빌드에 설명된 대로 패키지를 빌드합니다.

패키지를 설치합니다.

# dnf install /home/<username>/rpmbuild/RPMS/noarch/pello-0.1.2-1.el8.noarch.rpm

설치 후 출력 메시지를 확인합니다.

Installing       : pello-0.1.2-1.el8.noarch                              1/1
Running scriptlet: pello-0.1.2-1.el8.noarch                              1/1
This is python code

참고

Python 3 스크립트를 사용하려면 SPEC 파일에 install -m 아래에 다음 행을 추가하십시오.

%post -p /usr/bin/python3

Lua 스크립트를 사용하려면 SPEC 파일에 install -m 아래에 다음 행을 추가하십시오.

%post -p <lua>

이렇게 하면 SPEC 파일에서 인터프리터를 지정할 수 있습니다.

5.4. RPM 조건

RPM 조건을 사용하면 SPEC 파일의 다양한 섹션을 조건부로 포함할 수 있습니다.

조건부 포함은 일반적으로 다음을 처리합니다.

아키텍처별 섹션
운영 체제별 섹션
다양한 버전의 운영 체제 간 호환성 문제
매크로의 존재 및 정의

5.4.1. RPM 조건 구문

RPM 조건에서는 다음 구문을 사용합니다.

expression 이 true이면 몇 가지 작업을 수행합니다.

%if expression
…
%endif

expression 이 true이면 다른 작업을 수행하는 경우 다른 작업을 수행합니다.

%if expression
…
%else
…
%endif

5.4.2. %if 조건

다음 예제에서는 %if RPM 조건을 사용하는 방법을 보여줍니다.

예 5.3. %if 조건부를 사용하여 Red Hat Enterprise Linux 8과 기타 운영 체제 간의 호환성 처리

%if 0%{?rhel} == 8
sed -i '/AS_FUNCTION_DESCRIBE/ s/^/#/' configure.in
sed -i '/AS_FUNCTION_DESCRIBE/ s/^/#/' acinclude.m4
%endif

이 조건부는 AS_FUNCTION_DESCRIBE 매크로를 지원하는 측면에서 RHEL 8과 기타 운영 체제 간의 호환성을 처리합니다. RHEL용으로 패키지를 빌드하면 %rhel 매크로가 정의되고 RHEL 버전으로 확장됩니다. 해당 값이 8이므로 패키지가 RHEL 8에 대한 빌드인 경우 RHEL 8에서 지원하지 않는 AS_FUNCTION_DESCRIBE에 대한 참조가 autoconfig 스크립트에서 삭제됩니다.

예 5.4. %if 조건부를 사용하여 매크로 정의 처리

%define ruby_archive %{name}-%{ruby_version}
%if 0%{?milestone:1}%{?revision:1} != 0
%define ruby_archive %{ruby_archive}-%{?milestone}%{?!milestone:%{?revision:r%{revision}}}
%endif

이 조건부는 매크로의 정의를 처리합니다. %milestone 또는 %revision 매크로가 설정된 경우 업스트림 tarball의 이름을 정의하는 %ruby_archive 매크로가 다시 정의됩니다.

5.4.3. %if 조건의 특수 변형

%ifarch 조건, %ifnarch 조건, %ifnarch 조건부 및 %ifos 조건은 %if 조건의 특수 변형입니다. 이러한 변형은 일반적으로 사용되며, 따라서 자체 매크로가 있습니다.

%ifarch 조건

%ifarch 조건부는 아키텍처별 SPEC 파일 블록을 시작하는 데 사용됩니다. 그런 다음 각각 쉼표 또는 공백으로 구분된 하나 이상의 아키텍처 분류자가 뒤에 옵니다.

예 5.5. %ifarch 조건을 사용하는 예

%ifarch i386 sparc
…
%endif

%ifarch 와 %endif 사이의 SPEC 파일의 모든 내용은 32비트 AMD 및 Intel 아키텍처 또는 Sunmtls 기반 시스템에서만 처리됩니다.

%ifnarch 조건

%ifnarch 조건부에는 %ifarch 조건보다 역방향 논리가 있습니다.

예 5.6. %ifnarch 조건을 사용하는 예

%ifnarch alpha
…
%endif

%ifnarch 와 %endif 사이의 SPEC 파일의 모든 내용은 Digital Alpha/AXP 기반 시스템에서 수행되지 않은 경우에만 처리됩니다.

%ifos 조건

%ifos 조건부는 빌드의 운영 체제에 따라 처리를 제어하는 데 사용됩니다. 한 개 이상의 운영 체제 이름을 뒤에 넣을 수 있습니다.

예 5.7. %ifos 조건 사용 예

%ifos linux
…
%endif

%ifos 와 %endif 간 SPEC 파일의 모든 내용은 Linux 시스템에서 빌드가 수행된 경우에만 처리됩니다.

5.5. Python 3 RPM 패키징

pip 설치 프로그램을 사용하거나 DNF 패키지 관리자를 사용하여 업스트림 PyPI 리포지토리에서 시스템에 Python 패키지를 설치할 수 있습니다. DNF는 소프트웨어에 대한 다운스트림 제어를 제공하는 RPM 패키지 형식을 사용합니다.

네이티브 Python 패키지의 패키징 형식은 Python Packaging Authority (PyPA) 사양으로 정의됩니다. 대부분의 Python 프로젝트는 패키징에 distutils 또는 setuptools 유틸리티를 사용하고 setup.py 파일에서 정의된 패키지 정보를 사용합니다. 그러나 기본 Python 패키지를 만들 가능성이 시간이 지남에 따라 발전했습니다. 새로운 패키징 표준에 대한 자세한 내용은 pyproject-rpm-macros 를 참조하십시오.

이 장에서는 setup.py 를 RPM 패키지로 사용하는 Python 프로젝트를 패키징하는 방법을 설명합니다. 이 방법은 네이티브 Python 패키지와 비교하여 다음과 같은 이점을 제공합니다.

Python 및 비 Python 패키지에 대한 종속 항목을 사용할 수 있으며 DNF 패키지 관리자가 엄격하게 적용할 수 있습니다.
패키지를 암호화 방식으로 서명할 수 있습니다. 암호화 서명을 사용하면 RPM 패키지의 콘텐츠를 나머지 운영 체제와 검증, 통합 및 테스트할 수 있습니다.
빌드 프로세스 중에 테스트를 실행할 수 있습니다.

5.5.1. Python 패키지에 대한 SPEC 파일 설명

SPEC 파일에는 rpmbuild 유틸리티가 RPM을 빌드하는 데 사용하는 지침이 포함되어 있습니다. 지침은 여러 섹션에 포함되어 있습니다. SPEC 파일에는 섹션이 정의된 두 가지 주요 부분이 있습니다.

Preamble (본문에 사용되는 일련의 메타데이터 항목 포함)
본문(명령의 주요 부분 포함)

Python 프로젝트의 RPM SPEC 파일에는 Python이 아닌 SPEC 파일에 비해 몇 가지 구체적인 내용이 있습니다.

중요

Python 라이브러리의 RPM 패키지 이름에는 항상 python3- 또는 python3.11- 접두사가 포함되어야 합니다.

기타 세부 사항은 python3*-pello 패키지에 대한 다음 SPEC 파일 예제에 표시되어 있습니다. 이러한 세부 사항에 대한 설명은 예제 아래의 노트를 참조하십시오.

Python으로 작성된 pello 프로그램의 SPEC 파일의 예

%global python3_pkgversion 3.11                                       1

Name:           python-pello                                          2
Version:        1.0.2
Release:        1%{?dist}
Summary:        Example Python library

License:        MIT
URL:            https://github.com/fedora-python/Pello
Source:         %{url}/archive/v%{version}/Pello-%{version}.tar.gz

BuildArch:      noarch
BuildRequires:  python%{python3_pkgversion}-devel                     3

# Build dependencies needed to be specified manually
BuildRequires:  python%{python3_pkgversion}-setuptools

# Test dependencies needed to be specified manually
# Also runtime dependencies need to be BuildRequired manually to run tests during build
BuildRequires:  python%{python3_pkgversion}-pytest >= 3


%global _description %{expand:
Pello is an example package with an executable that prints Hello World! on the command line.}

%description %_description

%package -n python%{python3_pkgversion}-pello                         4
Summary:        %{summary}

%description -n python%{python3_pkgversion}-pello %_description


%prep
%autosetup -p1 -n Pello-%{version}


%build
# The macro only supported projects with setup.py
%py3_build                                                            5


%install
# The macro only supported projects with setup.py
%py3_install


%check                                                                6
%{pytest}


# Note that there is no %%files section for the unversioned python module
%files -n python%{python3_pkgversion}-pello
%doc README.md
%license LICENSE.txt
%{_bindir}/pello_greeting

# The library files needed to be listed manually
%{python3_sitelib}/pello/

# The metadata files needed to be listed manually
%{python3_sitelib}/Pello-*.egg-info/

1: python3_pkgversion 매크로를 정의하면 이 패키지가 빌드할 Python 버전을 설정합니다. 기본 Python 버전 3.9를 빌드하려면 매크로를 기본값 3 으로 설정하거나 행을 완전히 제거합니다.
2: Python 프로젝트를 RPM에 패키징할 때 항상 프로젝트의 원래 이름에 python- 접두사를 추가합니다. 원래 이름은 pello 이므로 Source RPM (SRPM)의 이름은 python-pello 입니다.
3: BuildRequires 는 이 패키지를 빌드하고 테스트하는 데 필요한 패키지를 지정합니다. BuildRequires 에서는 항상 python3-devel (또는 python3.11-devel)과 패키지하는 특정 소프트웨어에 필요한 관련 프로젝트 (예: python3-setuptools (또는 python3.11-setuptools) 또는 %check 섹션에서 테스트를 실행하는 데 필요한 런타임 및 테스트 종속성과 같은 Python 패키지 빌드에 필요한 툴을 제공하는 항목을 포함합니다.
4: 바이너리 RPM의 이름(사용자가 설치할 수 있는 패키지)을 선택할 때 버전 지정된 Python 접두사를 추가합니다. 기본 Python 3.9에는 python3- 접두사 또는 Python 3.11의 경우 python3.11- 접두사를 사용합니다. %{python3_pkgversion} 매크로를 사용할 수 있습니다. 이 매크로는 명시적 버전(예: 3.11 참조)으로 설정하지 않는 한 기본 Python 버전 3.9에 대해 3 으로 평가됩니다.
5: %py3_build 및 %py3_install 매크로는 각각 setup.py build 및 setup.py install 명령을 실행하여 설치 위치, 사용할 인터프리터를 지정하는 추가 인수와 함께 실행합니다.
6: %check 섹션에서는 패키지 프로젝트의 테스트를 실행해야 합니다. 정확한 명령은 프로젝트 자체에 따라 달라지지만 %pytest 매크로를 사용하여 RPM 친화적인 방식으로 pytest 명령을 실행할 수 있습니다.

5.5.2. Python 3 RPM의 일반적인 매크로

SPEC 파일에서는 항상 값을 하드 코딩하지 않고 다음 Macros for Python 3 RPMs 테이블에 설명된 매크로를 사용합니다. SPEC 파일 상단에 python3_pkgversion 매크로를 정의하여 이러한 매크로에서 어떤 Python 3 버전이 사용되는지 확인할 수 있습니다( 5.5.1절. “Python 패키지에 대한 SPEC 파일 설명”참조). python3_pkgversion 매크로를 정의하는 경우 다음 표에 설명된 매크로 값은 지정된 Python 3 버전을 반영합니다.

표 5.3. Python 3 RPM용 매크로

macro	일반 정의	설명
%{python3_pkgversion}	3	다른 모든 매크로에서 사용하는 Python 버전입니다. Python `3.11` 을 사용하도록 3.11로 다시 정의할 수 있습니다.
%{python3}	/usr/bin/python3	Python 3 인터프리터
%{python3_version}	3.9	Python 3 인터프리터의 major.minor 버전
%{python3_sitelib}	/usr/lib/python3.9/site-packages	pure-Python 모듈이 설치된 위치
%{python3_sitearch}	/usr/lib64/python3.9/site-packages	아키텍처별 확장 모듈을 포함하는 모듈이 설치된 위치
%py3_build		RPM 패키지에 적합한 인수와 함께 `setup.py build` 명령 실행
%py3_install		RPM 패키지에 적합한 인수와 함께 `setup.py install` 명령 실행
%{py3_shebang_flags}	s	Python 인터프리터 지시문 매크로, `%py3_shebang_fix`의 기본 플래그 세트
%py3_shebang_fix		Python 인터프리터 지시문을 `#! %{python3}` 로 변경하고 기존 플래그(있는 경우)를 유지하고 `%{py3_shebang_flags}` 매크로에 정의된 플래그를 추가합니다.

추가 리소스

업스트림 문서의 Python 매크로

5.5.3. Python RPM에 자동 생성된 종속 항목 사용

다음 절차에서는 Python 프로젝트를 RPM으로 패키징할 때 자동으로 생성된 종속 항목을 사용하는 방법을 설명합니다.

사전 요구 사항

RPM용 SPEC 파일이 있습니다. 자세한 내용은 Python 패키지에 대한 SPEC 파일 설명을 참조하십시오.

절차

업스트림 제공 메타데이터가 포함된 다음 디렉터리 중 하나가 결과 RPM에 포함되어 있는지 확인합니다.
- .dist-info
- .egg-info
  RPM 빌드 프로세스는 다음과 같이 이러한 디렉터리에서 제공하는 가상 pythonX.Ydist 를 자동으로 생성합니다.
```
python3.9dist(pello)
```
  그런 다음 Python 종속성 생성기는 업스트림 메타데이터를 읽고 생성된 pythonX.Ydist 가상 기능을 사용하여 각 RPM 패키지에 대한 런타임 요구 사항을 생성합니다. 예를 들어 생성된 요구 사항 태그는 다음과 같을 수 있습니다.
```
Requires: python3.9dist(requests)
```
생성된 요구 사항을 검사합니다.
생성된 요구 중 일부를 제거하려면 다음 방법 중 하나를 사용합니다.
1. SPEC 파일의 %prep 섹션에서 업스트림 제공 메타데이터를 수정합니다.
2. 업스트림 설명서에 설명된 종속성을 자동 필터링하여 사용합니다.
자동 종속성 생성기를 비활성화하려면 기본 패키지의 %description 선언 위에 %{?python_disable_dependency_generator} 매크로를 포함합니다.

추가 리소스

자동 생성된 종속 항목

5.6. Python 스크립트에서 인터프리터 지시문 처리

Red Hat Enterprise Linux 9에서는 실행 가능한 Python 스크립트는 최소 주요 Python 버전에서 명시적으로 지정하는 인터프리터 지시문( hashbangs 또는 shebangs라고도 함)을 사용해야 합니다. 예를 들어 다음과 같습니다.

#!/usr/bin/python3
#!/usr/bin/python3.9
#!/usr/bin/python3.11

RPM 패키지를 빌드할 때 /usr/lib/rpm/redhat/brp-mangle-shebangs BRP(Buildroot 정책) 스크립트를 자동으로 실행하고 모든 실행 파일에서 인터프리터 지시문을 수정하려고 시도합니다.

BRP 스크립트는 다음과 같은 모호한 인터프리터 지시문을 사용하여 Python 스크립트를 시작할 때 오류를 생성합니다.

#!/usr/bin/python

또는

#!/usr/bin/env python

5.6.1. Python 스크립트에서 인터프리터 지시문 수정

다음 절차에 따라 RPM 빌드 시 빌드 오류가 발생하는 Python 스크립트에서 인터프리터 지시문을 수정합니다.

사전 요구 사항

Python 스크립트의 인터프리터 지시문 중 일부는 빌드 오류가 발생합니다.

절차

인터프리터 지시문을 수정하려면 다음 작업 중 하나를 완료합니다.
- SPEC 파일의 %prep 섹션에서 다음 매크로를 사용합니다.
```
# %py3_shebang_fix SCRIPTNAME …
```
  SCRIPTNAME 은 모든 파일, 디렉터리 또는 파일 및 디렉터리 목록일 수 있습니다.
  결과적으로 나열된 디렉터리의 모든 파일 및 모든 .py 파일은 %{python3} 을 가리키도록 인터프리터 지시문을 수정합니다. 원래 인터프리터 지시문의 기존 플래그는 보존되고 %{py3_shebang_flags} 매크로에 정의된 추가 플래그가 추가됩니다. SPEC 파일에서 %{py3_shebang_flags} 매크로를 재정의하여 추가할 플래그를 변경할 수 있습니다.
- python3-devel 패키지에서 pathfix.py 스크립트를 적용합니다.
```
# pathfix.py -pn -i %{python3} PATH …
```
  여러 경로를 지정할 수 있습니다. PATH 가 디렉터리인 경우 pathfix.py 는 모호한 인터프리터 지시문이 있는 것뿐만 아니라 ^[a-zA-Z0-9_]+\.py$ 패턴과 일치하는 Python 스크립트를 반복적으로 검사합니다. 위의 명령을 %prep 섹션에 추가하거나 %install 섹션의 끝에 추가합니다.
- 패키지된 Python 스크립트를 수정하여 예상 형식을 준수하도록 합니다. 이를 위해 RPM 빌드 프로세스 외부의 pathfix.py 스크립트도 사용할 수 있습니다. RPM 빌드 외부에서 pathfix.py 를 실행하는 경우 이전 예제의 %{python3} 을 /usr/bin/python3 또는 /usr/bin/python3.11 과 같은 인터프리터 지시문의 경로로 바꿉니다.

추가 리소스

인터프리터 호출

5.7. RubyGems 패키지

이 섹션에서는 RubyGems 패키지가 무엇인지, 그리고 RPM으로 다시 패키징하는 방법에 대해 설명합니다.

5.7.1. RubyGems의 정의

Ruby는 동적, 해석, 반사, 객체 지향, 일반 목적의 프로그래밍 언어입니다.

Ruby로 작성된 프로그램은 일반적으로 특정 Ruby 패키징 형식을 제공하는 RubyGems 프로젝트를 사용하여 패키징됩니다.

RubyGems에서 만든 패키지는 gems라고 하며 RPM으로도 다시 패키징할 수 있습니다.

참고

이 문서는 gem 접두사와 함께 RubyGems 개념과 관련된 용어(예: .gemspec)는 gem 사양에 사용되며 RPM 관련 용어는 정규화되지 않습니다.

5.7.2. RubyGems의 RPM 관련 방법

RubyGems는 Ruby의 자체 패키징 형식을 나타냅니다. 그러나 RubyGems에는 RPM에 필요한 메타데이터가 포함되어 있으며 RubyGems에서 RPM으로 변환할 수 있습니다.

Ruby Packaging guidelines 에 따르면 RubyGems 패키지를 RPM으로 다시 패키징할 수 있습니다.

이러한 RPM은 나머지 배포에 적합합니다.
최종 사용자는 적절한 RPM 패키지 gem을 설치하여 gem의 종속성을 충족할 수 있습니다.

RubyGems는 SPEC 파일, 패키지 이름, 종속성 및 기타 항목과 같은 RPM과 유사한 용어를 사용합니다.

나머지 RHEL RPM 배포에 적합하려면 RubyGems에서 생성한 패키지는 아래 나열된 규칙을 따라야 합니다.

gems의 이름은 다음 패턴을 따라야 합니다.
```
rubygem-%{gem_name}
```
shebang 라인을 구현하려면 다음 문자열을 사용해야 합니다.
```
#!/usr/bin/ruby
```

5.7.3. RubyGems 패키지에서 RPM 패키지 생성

RubyGems 패키지에 대한 소스 RPM을 만들려면 다음 파일이 필요합니다.

gem 파일
RPM SPEC 파일

다음 섹션에서는 RubyGems에서 만든 패키지에서 RPM 패키지를 만드는 방법에 대해 설명합니다.

5.7.3.1. RubyGems SPEC 파일 규칙

RubyGems SPEC 파일은 다음 규칙을 충족해야 합니다.

gem의 사양의 이름인 %{gem_name} 를 포함합니다.
패키지 소스는 릴리스된 gem 아카이브에 대한 전체 URL이어야 합니다. 패키지 버전은 gem의 버전이어야 합니다.
빌드에 필요한 매크로를 가져올 수 있도록 다음과 같이 정의된 지시문인 BuildRequires 가 포함되어 있습니다.
```
BuildRequires:rubygems-devel
```
RubyGems Requires 또는 Provides 가 자동으로 생성되기 때문에 포함되어 있지 않습니다.
Ruby 버전 호환성을 명시적으로 지정하지 않으려면 다음과 같이 정의된 BuildRequires: 지시문을 포함하지 않습니다.
```
Requires: ruby(release)
```
RubyGems에 자동으로 생성된 종속성(필수: ruby(rubygems))이면 충분합니다.

5.7.3.2. RubyGems 매크로

다음 표에는 RubyGems에서 만든 패키지에 유용한 매크로가 나열되어 있습니다. 이러한 매크로는 rubygems-devel 패키지에서 제공합니다.

표 5.4. RubyGems의 매크로

매크로 이름	확장 경로	사용법
%{gem_dir}	/usr/share/gems	gem 구조의 최상위 디렉터리입니다.
%{gem_instdir}	%{gem_dir}/gems/%{gem_name}-%{version}	gem의 실제 콘텐츠가 있는 디렉터리입니다.
%{gem_libdir}	%{gem_instdir}/lib	gem의 라이브러리 디렉터리입니다.
%{gem_cache}	%{gem_dir}/cache/%{gem_name}-%{version}.gem	캐시된 gem.
%{gem_spec}	%{gem_dir}/specifications/%{gem_name}-%{version}.gemspec	gem 사양 파일입니다.
%{gem_docdir}	%{gem_dir}/doc/%{gem_name}-%{version}	gem의 RDoc 문서입니다.
%{gem_extdir_mri}	%{_libdir}/gems/ruby/%{gem_name}-%{version}	gem 확장을 위한 디렉터리입니다.

5.7.3.3. RubyGems SPEC 파일 예

특정 섹션에 대한 설명과 함께 gem을 빌드하는 SPEC 파일의 예는 다음과 같습니다.

RubyGems SPEC 파일의 예

%prep
%setup -q -n  %{gem_name}-%{version}

# Modify the gemspec if necessary
# Also apply patches to code if necessary
%patch0 -p1

%build
# Create the gem as gem install only works on a gem file
gem build ../%{gem_name}-%{version}.gemspec

# %%gem_install compiles any C extensions and installs the gem into ./%%gem_dir
# by default, so that we can move it into the buildroot in %%install
%gem_install

%install
mkdir -p %{buildroot}%{gem_dir}
cp -a ./%{gem_dir}/* %{buildroot}%{gem_dir}/

# If there were programs installed:
mkdir -p %{buildroot}%{_bindir}
cp -a ./%{_bindir}/* %{buildroot}%{_bindir}

# If there are C extensions, copy them to the extdir.
mkdir -p %{buildroot}%{gem_extdir_mri}
cp -a .%{gem_extdir_mri}/{gem.build_complete,*.so} %{buildroot}%{gem_extdir_mri}/

다음 표에서는 RubyGems SPEC 파일의 특정 항목에 대한 세부 사항을 설명합니다.

표 5.5. RubyGems의 SPEC 지시문 특정

SPEC 지시문 RubyGems 세부 정보

SPEC 지시문	RubyGems 세부 정보
%Prep	RPM은 gem 아카이브의 직접 압축을 풀 수 있으므로 `gem에서 소스를 추출하기 위해 gem 압축` 을 풀 수 있습니다. `%setup -n %{gem_name}-%{version}` 매크로는 gem의 압축을 풀 수 있는 디렉터리를 제공합니다. 동일한 디렉터리 수준에서 `%{gem_name}-%{version} .gemspec` 파일이 자동으로 생성됩니다. 이 파일은 나중에 gem을 다시 빌드하거나 .gemspec을 수정하거나 .gemspec을 코드에 패치를 적용하는 데 사용할 수 있습니다.
%build	이 지시문에는 소프트웨어를 머신 코드로 빌드하는 명령 또는 일련의 명령이 포함되어 있습니다. `%gem_install` 매크로는 gem 아카이브에서만 작동하며 gem은 다음 gem 빌드로 다시 생성됩니다. 그런 다음 `%gem_install` 에서 생성된 gem 파일은 기본적으로 `./%{gem_dir}` 인 임시 디렉터리에 코드를 빌드하고 설치하는 데 사용됩니다. `%gem_install` 매크로는 한 단계로 코드를 빌드하고 설치합니다. 설치하기 전에 빌드된 소스는 자동으로 생성된 임시 디렉터리에 배치됩니다. `%gem_install` 매크로는 설치에 사용되는 gem을 재정의할 수 있는 `-n <gem_file>`, gem 설치 대상을 재정의할 수 있는 `-d <install_dir>`; 이 옵션을 사용하는 것은 권장되지 않습니다. `%gem_install` 매크로는 `%{buildroot}` 에 설치하는 데 사용해서는 안 됩니다.
%install	설치는 `%{buildroot}` 계층 구조로 수행됩니다. 필요한 디렉터리를 생성한 다음 임시 디렉터리에 설치된 디렉터리를 `%{buildroot}` 계층 구조로 복사할 수 있습니다. 이 gem이 공유 오브젝트를 생성하는 경우 아키텍처별 `%{gem_extdir_mri}` 경로로 이동합니다.

%Prep

RPM은 gem 아카이브의 직접 압축을 풀 수 있으므로 gem에서 소스를 추출하기 위해 gem 압축 을 풀 수 있습니다. %setup -n %{gem_name}-%{version} 매크로는 gem의 압축을 풀 수 있는 디렉터리를 제공합니다. 동일한 디렉터리 수준에서 %{gem_name}-%{version} .gemspec 파일이 자동으로 생성됩니다. 이 파일은 나중에 gem을 다시 빌드하거나 .gemspec을 수정하거나 .gemspec을 코드에 패치를 적용하는 데 사용할 수 있습니다.

%build

이 지시문에는 소프트웨어를 머신 코드로 빌드하는 명령 또는 일련의 명령이 포함되어 있습니다. %gem_install 매크로는 gem 아카이브에서만 작동하며 gem은 다음 gem 빌드로 다시 생성됩니다. 그런 다음 %gem_install 에서 생성된 gem 파일은 기본적으로 ./%{gem_dir} 인 임시 디렉터리에 코드를 빌드하고 설치하는 데 사용됩니다. %gem_install 매크로는 한 단계로 코드를 빌드하고 설치합니다. 설치하기 전에 빌드된 소스는 자동으로 생성된 임시 디렉터리에 배치됩니다.

%gem_install 매크로는 설치에 사용되는 gem을 재정의할 수 있는 -n <gem_file>, gem 설치 대상을 재정의할 수 있는 -d <install_dir>; 이 옵션을 사용하는 것은 권장되지 않습니다.

%gem_install 매크로는 %{buildroot} 에 설치하는 데 사용해서는 안 됩니다.

%install

설치는 %{buildroot} 계층 구조로 수행됩니다. 필요한 디렉터리를 생성한 다음 임시 디렉터리에 설치된 디렉터리를 %{buildroot} 계층 구조로 복사할 수 있습니다. 이 gem이 공유 오브젝트를 생성하는 경우 아키텍처별 %{gem_extdir_mri} 경로로 이동합니다.

추가 리소스

Ruby 패키징 지침

5.7.3.4. gem2rpm을 사용하여 RubyGems 패키지를 RPM SPEC 파일로 변환

gem2rpm 유틸리티는 RubyGems 패키지를 RPM SPEC 파일로 변환합니다.

다음 섹션에서는 다음 방법을 설명합니다.

gem2rpm 유틸리티 설치
모든 gem2rpm 옵션 표시
gem2rpm 을 사용하여 RPM SPEC 파일에 RubyGems 패키지를 포함
gem2rpm 템플릿 편집

5.7.3.4.1. gem2rpm 설치

다음 절차에서는 gem2rpm 유틸리티를 설치하는 방법을 설명합니다.

절차

RubyGems.org 에서 gem2rpm 을 설치하려면 다음을 실행합니다.

$ gem install gem2rpm

5.7.3.4.2. gem2rpm의 모든 옵션 표시

다음 절차에서는 gem2rpm 유틸리티의 모든 옵션을 표시하는 방법을 설명합니다.

절차

gem2rpm 의 모든 옵션을 보려면 다음을 실행합니다.
```
gem2rpm --help
```

5.7.3.4.3. gem2rpm을 사용하여 RPM SPEC 파일에 RubyGems 패키지 포함

다음 절차에서는 gem2rpm 유틸리티를 사용하여 RPM SPEC 파일에 RubyGems 패키지를 다루는 방법을 설명합니다.

절차

최신 버전에서 gem을 다운로드하고 이 gem에 대한 RPM SPEC 파일을 생성합니다.
```
$ gem2rpm --fetch <gem_name> > <gem_name>.spec
```

설명된 프로시저는 gem의 메타데이터에 제공된 정보를 기반으로 RPM SPEC 파일을 생성합니다. 그러나 gem은 라이센스 및 변경 로그와 같은 RPM에서 일반적으로 제공되는 몇 가지 중요한 정보를 놓치고 있습니다. 따라서 생성된 SPEC 파일을 편집해야 합니다.

5.7.3.4.4. gem2rpm 템플릿

gem2rpm 템플릿은 다음 표에 나열된 변수를 포함하는 표준 임베디드 Ruby(ERB) 파일입니다.

표 5.6. gem2rpm 템플릿의 변수

Variable	설명
패키지	gem의 `Gem::Package` 변수.
spec	gem의 `Gem::Specification` 변수( format.spec과 동일).
config	사양 템플릿 도우미에 사용되는 기본 매크로 또는 규칙을 재정의할 수 있는 `Gem2Rpm::Configuration` 변수.
runtime_dependencies	`Gem2Rpm::RpmDependencyList` 변수는 패키지 런타임 종속 항목 목록을 제공합니다.
development_dependencies	`Gem2Rpm::RpmDependencyList` 변수는 패키지 개발 종속 항목 목록을 제공합니다.
테스트	`Gem2Rpm::TestSuite` 변수는 실행할 수 있는 테스트 프레임워크 목록을 제공합니다.
파일	`Gem2Rpm::RpmFileList` 변수는 패키지에서 필터링되지 않은 파일 목록을 제공합니다.
main_files	`Gem2Rpm::RpmFileList` 변수는 기본 패키지에 적합한 파일 목록을 제공합니다.
doc_files	`Gem2Rpm::RpmFileList` 변수는 `-doc` 하위 패키지에 적합한 파일 목록을 제공합니다.
형식	gem의 `Gem::Format` 변수. 이 변수는 더 이상 사용되지 않습니다.

5.7.3.4.5. 사용 가능한 gem2rpm 템플릿 나열

다음 절차에서는 사용 가능한 모든 gem2rpm 템플릿을 나열하도록 설명합니다.

절차

사용 가능한 모든 템플릿을 보려면 다음을 실행합니다.
```
$ gem2rpm --templates
```

5.7.3.4.6. gem2rpm 템플릿 편집

생성된 SPEC 파일을 편집하는 대신 RPM SPEC 파일이 생성되는 템플릿을 편집할 수 있습니다.

gem2rpm 템플릿을 편집하려면 다음 절차를 사용하십시오.

절차

기본 템플릿을 저장합니다.

$ gem2rpm -T > rubygem-<gem_name>.spec.template

필요에 따라 템플릿을 편집합니다.

편집된 템플릿을 사용하여 SPEC 파일을 생성합니다.

$ gem2rpm -t rubygem-<gem_name>.spec.template <gem_name>-<latest_version.gem > <gem_name>-GEM.spec

이제 RPM 빌드에 설명된 대로 편집된 템플릿을 사용하여 RPM 패키지를 빌드할 수 있습니다.

5.8. Perls 스크립트를 사용하여 RPM 패키지를 처리하는 방법

RHEL 8부터 Perl 프로그래밍 언어는 기본 buildroot에 포함되지 않습니다. 따라서 Perl 스크립트를 포함하는 RPM 패키지는 RPM SPEC 파일에서 BuildRequires: 지시문을 사용하여 Perl에 대한 종속성을 명시적으로 나타내야 합니다.

5.8.2. 특정 Perl 모듈 사용

빌드 시 특정 Perl 모듈이 필요한 경우 다음 절차를 사용하십시오.

절차

RPM SPEC 파일에 다음 구문을 적용합니다.
```
BuildRequires: perl(MODULE)
```
참고
시간이 지남에 따라 perl 패키지로 이동할 수 있기 때문에 Perl core 모듈에도 이 구문을 적용합니다.

5.8.3. 패키지를 특정 Perl 버전으로 제한

패키지를 특정 Perl 버전으로 제한하려면 다음 절차를 따르십시오.

절차

RPM SPEC 파일에서 원하는 버전 제약 조건과 함께 perl(:VERSION) 종속성을 사용합니다.
예를 들어 패키지를 Perl 버전 5.30 이상으로 제한하려면 다음을 사용하십시오.
```
BuildRequires: perl(:VERSION) >= 5.30
```

주의

epoch 번호가 포함되어 있기 때문에 perl 패키지 버전에 대한 비교를 사용하지 마십시오.

5.8.4. 패키지가 올바른 Perl 인터프리터를 사용하는지 확인

Red Hat은 완전히 호환되지 않는 여러 Perl 인터프리터를 제공합니다. 따라서 Perl 모듈을 제공하는 모든 패키지는 빌드 시 사용된 것과 동일한 Perl 인터프리터를 런타임에 사용해야 합니다.

이를 확인하려면 다음 절차를 따르십시오.

절차

Perl 모듈을 제공하는 모든 패키지에 대해 RPM SPEC 파일에 버전 지정된 MODULE_COMPAT Requires 를 포함합니다.
```
Requires:  perl(:MODULE_COMPAT_%(eval `perl -V:version`; echo $version))
```

6장. RHEL 9의 새로운 기능

이 섹션에서는 Red Hat Enterprise Linux 8과 9 사이의 RPM 패키지의 주요 변경 사항을 문서화합니다.

6.1. 동적 빌드 종속 항목

Red Hat Enterprise Linux 9에는 동적 빌드 종속 항목을 생성할 수 있는 %generate_buildrequires 섹션이 도입되었습니다.

이제 새로 사용 가능한 %generate_buildrequires 스크립트를 사용하여 RPM 빌드 시 추가 빌드 종속 항목을 프로그래밍 방식으로 생성할 수 있습니다. 이 기능은 특수 유틸리티가 일반적으로 러스트, Golang, Node.js, Ruby, Python 또는 Haskell과 같은 런타임 종속성을 결정하는 데 사용되는 언어로 작성된 소프트웨어를 패키징할 때 유용합니다.

%generate_buildrequires 스크립트를 사용하여 빌드 시 SPEC 파일에 추가된 BuildRequires 지시문을 동적으로 확인할 수 있습니다. 존재하는 경우 %generate_buildrequires 는 %prep 섹션 다음에 실행되며 압축 풀기 및 패치된 소스 파일에 액세스할 수 있습니다. 스크립트는 일반 BuildRequires 지시문과 동일한 구문을 사용하여 확인된 빌드 종속 항목을 표준 출력에 출력해야 합니다.

그런 다음 rpmbuild 유틸리티는 빌드를 계속하기 전에 종속성이 충족되는지 확인합니다.

일부 종속 항목이 누락된 경우 .buildreqs.nosrc.rpm 접미사가 있는 패키지가 생성되어 있으며 여기에는 확인된 BuildRequires 및 소스 파일이 포함되어 있습니다. 이 패키지를 사용하여 빌드를 다시 시작하기 전에 dnf builddep 명령으로 누락된 빌드 종속 항목을 설치할 수 있습니다.

자세한 내용은 rpmbuild(8) 도움말 페이지의 DYNAMIC BUILD DEPENDENCIES 섹션을 참조하십시오.

추가 리소스

rpmbuild(8) 도움말 페이지
yum-builddep(1) 매뉴얼 페이지

6.2. 개선된 패치 선언

6.2.1. 자동 패치 및 소스 번호 지정

Patch: 및 Source: 숫자가 없는 태그는 이제 나열된 순서에 따라 자동으로 번호가 지정됩니다.

번호 매기기는 마지막 수동으로 번호가 매겨진 항목부터 rpmbuild 유틸리티에 의해 내부적으로 실행되거나 이러한 항목이 없는 경우 0 이 실행됩니다.

예를 들어 다음과 같습니다.

Patch: one.patch
Patch: another.patch
Patch: yet-another.patch

6.2.2. `%patchlist` 및 `%sourcelist` 섹션

이제 새로 추가된 %patchlist 및 %sourcelist 섹션을 사용하여 각 항목 앞에 각 항목 없이 패치 및 소스 파일을 나열할 수 있습니다.

예를 들어 다음 항목은 다음과 같습니다.

Patch0: one.patch
Patch1: another.patch
Patch2: yet-another.patch

이제 다음과 같이 교체할 수 있습니다.

%patchlist
one.patch
another.patch
yet-another.patch

6.2.3. `%autopatch` 이제 패치 범위를 수락

이제 %autopatch 매크로는 -m 및 -M 매개변수를 수락하여 적용할 최소 및 최대 패치 번호를 제한합니다.

m 매개변수는 패치를 적용할 때 시작할 패치 번호(포함)를 지정합니다.
-M 매개변수는 패치 적용 시 중지할 패치 번호(포함)를 지정합니다.

이 기능은 특정 패치 세트 간에 작업을 수행해야 하는 경우에 유용할 수 있습니다.

6.3. 기타 기능

Red Hat Enterprise Linux 9의 RPM 패키징과 관련된 기타 새로운 기능은 다음과 같습니다.

빠른 매크로 기반 종속성 생성기
다이어리 연산자 및 네이티브 버전 비교를 포함한 강력한 매크로 및 %if 표현식
메타 종속성(unordered) 종속 항목
캐럿 버전 운영자(^)는 기본 버전보다 큰 버전을 표시하는 데 사용할 수 있습니다. 이 연산자는 반대 의미를 갖는 틸드( ~) 연산자를 보완합니다.
%elif,%elifos 및 %elifarch 문

7장. 추가 리소스

RPM, RPM 패키징 및 RPM 빌드와 관련된 다양한 주제에 대한 참조는 다음과 같습니다.

법적 공지

The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.

Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.

Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.

Linux® is the registered trademark of Linus Torvalds in the United States and other countries.

Java® is a registered trademark of Oracle and/or its affiliates.

XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.

MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.

Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.

The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.

All other trademarks are the property of their respective owners.

Language and Page Formatting Options

소프트웨어 패키징 및 배포

RPM 패키지 관리 시스템을 사용하여 소프트웨어 패키지 패키지

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat 문서에 관한 피드백 제공

1장. RPM 소개

1.1. RPM 패키지

1.2. RPM 패키징 유틸리티 나열

2장. RPM 패키징 소프트웨어 생성

2.1. 소스 코드란

2.2. 소프트웨어 생성 방법

2.2.1. 기본적으로 컴파일된 소프트웨어

2.2.2. 해석된 소프트웨어

2.3. 소스에서 소프트웨어 빌드

2.3.1. 기본적으로 컴파일된 코드에서 소프트웨어 빌드

2.3.1.1. 수동으로 cello 소프트웨어 빌드

2.3.1.2. 셀오 프로그램에 대한 자동화된 빌딩 설정

2.3.2. 소스 코드 해석

2.3.2.1. pello 프로그램 바이트 컴파일

2.3.2.2. Bello 프로그램 원시 중단

3장. RPM 패키지 소프트웨어 준비

3.1. 패치 소프트웨어

3.1.1. cello 프로그램에 대한 패치 파일 생성

3.1.2. 셀로 프로그램 패치

3.2. LICENSE 파일 만들기

3.3. 소스 코드를 tarball에 배치

3.3.1. 벨로 프로그램을 tarball에 배치

3.3.2. pello 프로그램을 tarball에 배치

3.3.3. cello 프로그램을 tarball에 배치

4장. 패키지 소프트웨어

4.1. RPM 패키지 작업 공간 설정

4.2. SPEC 파일이란 무엇입니까?

4.2.1. 사전 항목

4.2.2. 본문 항목

4.2.3. 고급 항목

4.3. BuildRoots

4.4. RPM 매크로

4.5. SPEC 파일 작업

4.5.1. rpmdev-newspec을 사용하여 새 SPEC 파일 만들기

4.5.2. RPM을 생성하기 위해 원래 SPEC 파일 수정

4.5.3. bash로 작성된 프로그램의 SPEC 파일 예제

4.5.4. Python으로 작성된 프로그램의 SPEC 파일 예제

4.5.5. C로 작성된 프로그램의 SPEC 파일 예제

4.6. RPM 빌드

4.6.1. 소스 RPM 빌드

4.6.2. 소스 RPM에서 바이너리 RPM 재빌드

4.6.3. SPEC 파일에서 바이너리 RPM 빌드

4.6.4. 소스 RPM에서 바이너리 RPM 빌드

4.7. RPM에서 온전성 확인

4.7.1. Sanity에 대한 벨로오 확인

4.7.1.1. bello SPEC File for sanity 확인

4.7.1.2. 벨로 바이너리 RPM에서 온전성을 확인

4.7.2. 장로에서 장난을 확인

4.7.2.1. 보안을 위해 pello SPEC 파일 확인

4.7.2.2. 보안을 위해 pello 바이너리 RPM 확인

4.7.3. Sanity에 대한 셀러 확인

4.7.3.1. 셀오 SPEC 파일에서 온전성 확인

4.7.3.2. 셀로 바이너리 RPM에서 온전성 확인

4.8. syslog에 RPM 활동 기록

4.9. RPM 콘텐츠 추출

5장. 고급 주제

5.1. RPM 패키지 서명

5.1.1. GPG 키 생성

5.1.2. 패키지에 서명하도록 RPM 구성

5.1.3. RPM 패키지에 서명 추가

5.2. 매크로에 대한 추가 정보

5.2.1. 자체 매크로 정의

5.2.2. %setup 매크로 사용

5.2.2.1. %setup -q 매크로 사용

5.2.2.2. %setup -n 매크로 사용

5.2.2.3. %setup -c 매크로 사용

5.2.2.4. %setup -D 및 %setup -T 매크로 사용

5.2.2.5. %setup -a 및 %setup -b 매크로 사용

5.2.3. %files 섹션의 공통 RPM 매크로

5.2.4. 내장 매크로 표시

5.2.5. RPM 배포 매크로

5.2.6. 사용자 정의 매크로 생성

5.3. epoch, Scriptlets 및 Triggers

5.3.1. Epoch 지시문

5.3.2. scriptlets 지시문

2.3.1.1. 수동으로 `cello` 소프트웨어 빌드

2.3.2.1. `pello` 프로그램 바이트 컴파일

2.3.2.2. Bello 프로그램 원시 `중단`

3.1.1. `cello` 프로그램에 대한 패치 파일 생성

3.1.2. 셀로 `프로그램` 패치

3.2. `LICENSE` 파일 만들기

3.3.1. 벨로 `프로그램을` tarball에 배치

3.3.2. `pello` 프로그램을 tarball에 배치

6.2.2. `%patchlist` 및 `%sourcelist` 섹션

6.2.3. `%autopatch` 이제 패치 범위를 수락