4.3. 구성 파일에 지원되는 이미지 사용자 정의


TOML 또는 JSON 형식의 빌드 구성 파일을 사용하여 결과 디스크 이미지에 대한 사용자 지정을 추가할 수 있습니다. 컨테이너 디렉터리는 구성 파일을 /config.toml 에 매핑합니다. custom 오브젝트는 이미지 수정 사항을 정의합니다.

또한 /usr/lib/bootc-image-builder 디렉터리에 config.json 또는 config.toml 로 빌드 구성 파일을 포함할 수 있습니다. 명시적으로 재정의하지 않는 한 시스템은 이러한 기본 사용자 지정을 사용합니다. JSON 형식의 경우 --config 인수를 사용할 때 stdin 을 사용하여 구성을 전달할 수도 있습니다.

사용자 정의

사용자를 디스크 이미지에 추가하고 선택적으로 SSH 키를 설정합니다. 이 섹션의 모든 필드는 이름을 제외하고 선택 사항입니다.

Expand
TOMLJSON
[[customizations.user]]
name = "user"
password = "password"
key = "ssh-rsa AAA ... user@email.com"
groups = ["wheel"]
{
  "customizations": {
    "user": [
      {
        "name": "user",
        "password": "password",
        "key": "ssh-rsa AAA ... user@email.com",
        "groups": [
          "wheel",
          "admins"
        ]
      }
    ]
  }
}
커널 구성

구성 파일에서 커널 부팅 매개변수를 사용자 지정할 수 있습니다.

Expand
TOMLJSON
[customizations.kernel]
name = "kernel-debug"
append = "nosmt=force"
{
  "customizations": {
    "kernel": {
      "append": "mitigations=auto,nosmt"
    }
  }
}
파일 시스템 구성

사용자 정의의 파일 시스템 섹션을 사용하여 / 및 /boot 와 같은 기본 파티션의 최소 크기를 설정하고 / var 아래에 마운트 지점이 있는 추가 파티션을 만들 수 있습니다.

Expand
TOMLJSON
[[customizations.filesystem]]
mountpoint = "/"
minsize = "10 GiB"

[[customizations.filesystem]]
mountpoint = "/var/data"
minsize = "20 GiB"
{
  "customizations": {
    "filesystem": [
      {
        "mountpoint": "/",
        "minsize": "10 GiB"
      },
      {
        "mountpoint": "/var/data",
        "minsize": "20 GiB"
      }
    ]
  }
}
rootfs와 파일 시스템 유형 상호 작용

루트 파일 시스템 유형(--rootfs) 인수가 소스 컨테이너의 기본값을 재정의합니다. ext4,xfs, btrfs 유형의 모든 추가 마운트 지점에 대한 파일 시스템 유형도 설정합니다.

지원되는 마운트 지점 및 크기의 경우 rootfsbtrfs 인 경우 다음 제한 사항 및 규칙이 적용됩니다.

  • / 를 지정하여 root 파일 시스템의 최소 크기를 설정할 수 있습니다. 부팅된 시스템의 /sysroot 에 마운트된 파일 시스템의 최종 크기이며 이 구성의 값과 같거나 기본 컨테이너의 크기가 더 큰 값과 같습니다.
  • /boot 를 지정하여 부팅 파티션의 최소 크기를 설정할 수 있습니다. /var 의 하위 디렉토리도 지정할 수 있지만 /var 에서는 symlink를 지정할 수 없습니다. 예를 들어 /var/home/var/run 은 symlinks이며 자체적으로 파일 시스템이 될 수 없습니다.
  • /var 자체는 마운트 지점이 될 수 없습니다. rootfs 옵션은 루트 파일 시스템의 파일 시스템 유형을 정의합니다.
  • 현재는 빌드 시 btrfs 하위 볼륨을 생성할 수 없습니다. 따라서 rootfsbtrfs 인 경우 /var 에서 사용자 지정 마운트 지점이 지원되지 않습니다. //boot 만 구성할 수 있습니다.
Anaconda ISO(installer) 구성 옵션

선택한 설치 명령이 포함된 Kickstart 파일을 만듭니다. 그런 다음 ISO 빌드에 Kickstart 파일을 추가하여 완전히 사용자 지정 및 자동화된 설치 미디어를 생성합니다.

참고

[customizations.user][customizations.installer.kickstart]. Kickstart를 추가할 때 여러 줄 문자열이 오류되기 때문에 TOML 형식으로 구성 파일을 사용합니다.

Expand
TOMLJSON
[customizations.installer.kickstart]
contents = """
text --non-interactive
zerombr
clearpart --all --initlabel --disklabel=gpt
autopart --noswap --type=lvm
network --bootproto=dhcp --device=link --activate --onboot=on
"""
{
  "customizations": {
    "installer": {
      "kickstart": {
        "contents": "text --non-interactive\nzerombr\nclearpart --all --initlabel --disklabel=gpt\nautopart --noswap --type=lvm\nnetwork --bootproto=dhcp --device=link --activate --onboot=on"
      }
    }
  }
}
주의

bootc-image-builder 는 컨테이너 이미지 외에 Kickstart 명령을 추가하지 않습니다. 이 명령은 시스템이 컨테이너 이미지에 자동으로 추가됩니다. 자세한 내용은 Kickstart 파일 생성 을 참조하십시오.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

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

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동