3.2. glance-scrubber.conf

allow_additional_image_properties = True

부울 값

사용자가 이미지에 추가/사용자 지정 속성을 추가할 수 있습니다.

Glance는 모든 이미지에 표시되는 표준 속성 집합(고급 스키마)을 정의합니다. 이러한 속성을 기본 속성 이라고도 합니다. Glance를 사용하면 이러한 속성 외에도 사용자가 이미지에 사용자 지정 속성을 추가할 수 있습니다. 이러한 속성을 추가 속성 이라고 합니다.

기본적으로 이 구성 옵션은 True 로 설정되며 사용자는 추가 속성을 추가할 수 있습니다. 이미지에 추가할 수 있는 추가 속성 수는 image_property_quota 구성 옵션을 통해 제어할 수 있습니다.

가능한 값은 다음과 같습니다.

관련 옵션:

api_limit_max = 1000

정수 값

요청에서 반환할 수 있는 최대 결과 수입니다.

limit_param_default 의 도움말 텍스트에 설명된 대로 일부 요청은 여러 결과를 반환할 수 있습니다. 반환되는 결과 수는 요청의 limit 매개 변수 또는 limit _param_default 구성 옵션으로 관리합니다. 두 경우 모두 이 구성 옵션으로 정의한 절대 최대값보다 클 수 없습니다. 이 값보다 큰 값은 여기에 정의된 최대 값으로 줄어듭니다.

가능한 값은 다음과 같습니다.

관련 옵션:

daemon = False

부울 값

데몬으로 스크럽을 실행합니다.

이 부울 구성 옵션은 스크럽을 이미지를 스크럽하기 위해 정기적으로 실행되는 장기 실행 프로세스로 실행해야 하는지 여부를 나타냅니다. 구성 옵션 alarm up_time을 사용하여 Wake up 간격을 지정할 수 있습니다.

이 구성 옵션이 기본값인 False 로 설정된 경우 스크럽은 이미지를 스크럽하고 종료하는 데 한 번 실행됩니다. 이 경우 운영자가 이미지 스크럽을 지속적으로 구현하려면 스크럽을 cron 작업으로 예약해야 합니다.

가능한 값은 다음과 같습니다.

관련 옵션:

data_api = glance.db.sqlalchemy.api

문자열 값

(REMOVAL용(DEPRECATED FOR REMOVAL) 데이터 액세스 API의 Python 모듈 경로입니다.

데이터 모델 액세스에 사용할 API의 경로를 지정합니다. 이 옵션은 이미지 카탈로그 데이터에 액세스하는 방법을 결정합니다.

가능한 값은 다음과 같습니다.

이 옵션이 glance.db.sqlalchemy.api 로 설정된 경우 이미지 카탈로그 데이터는 SQLAlchemy Core 및 ORM API를 통해 데이터베이스에서 읽습니다.

이 옵션을 glance.db.registry.api 로 설정하면 모든 데이터베이스 액세스 요청이 레지스트리 서비스를 통해 라우팅됩니다. 이렇게 하면 추가 보안 계층, 확장성 및 관리 용이성을 위해 Glance API 노드에서 데이터 액세스가 방지됩니다.

마지막으로 이 구성 옵션을 glance.db.simple.api 로 설정하면 이미지 카탈로그 데이터가 에 저장되고 메모리 내 데이터 구조에서 읽습니다. 이는 주로 테스트에 사용됩니다.

관련 옵션:

debug = False

부울 값

true로 설정하면 로깅 수준이 기본 INFO(정보) 수준이 아닌 DEBUG(디버그)로 설정됩니다.

default_log_levels = ['amqp=WARN', 'amqplib=WARN', 'boto=WARN', 'qpid=WARN', 'sqlalchemy=WARN', 'suds=INFO', 'oslo.messaging=INFO', 'oslo_messaging=INFO', 'iso8601=WARN', 'requests.packages.urllib3.connectionpool=WARN', 'urllib3.connectionpool=WARN', 'websocket=WARN', 'requests.packages.urllib3.util.retry=WARN', 'urllib3.util.retry=WARN', 'keystonemiddleware=WARN', 'routes.middleware=WARN', 'stevedore=WARN', 'taskflow=WARN', 'keystoneauth=WARN', 'oslo.cache=INFO', 'oslo_policy=INFO', 'dogpile.core.dogpile=INFO']

목록 값

logger=LEVEL 쌍의 패키지 로깅 수준 목록입니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다.

delayed_delete = False

부울 값

지연된 삭제를 켜거나 끌 수 있습니다.

일반적으로 이미지를 삭제하면 glance-api 서비스에서 이미지를 삭제된 상태로 저장하고 동시에 데이터를 삭제합니다. 지연된 삭제는 Glance에서 이후 시점까지 이미지 데이터의 실제 삭제를 지연하는 기능입니다(구성 옵션인 스크럽_time에 따라 결정됨). 지연된 삭제가 켜지면 glance-api 서비스는 삭제 시 이미지를 pending_delete 상태로 저장하고 나중에 이미지 스크럽을 삭제하도록 스토리지 백엔드에 이미지 데이터를 둡니다. 이미지 데이터가 성공적으로 삭제되면 이미지 스크럽이 이미지가 삭제된 상태로 이동합니다.

가능한 값은 다음과 같습니다.

관련 옵션:

digest_algorithm = sha256

문자열 값

디지털 서명에 사용할 다이제스트 알고리즘입니다.

디지털 서명을 생성하는 데 사용할 다이제스트 알고리즘을 나타내는 문자열 값을 제공합니다. 기본적으로 sha256 이 사용됩니다.

플랫폼에서 OpenSSL 버전에서 지원하는 사용 가능한 알고리즘 목록을 가져오려면 openssl list-message-digest-algorithms 명령을 실행합니다. 예를 들면 sha1,sha256 및 sha512 가 있습니다.

가능한 값은 다음과 같습니다.

관계 옵션:

enable_v1_registry = True

부울 값

enable_v2_api = True

부울 값

v2 OpenStack Images API를 배포합니다.

이 옵션을 True 로 설정하면 Glance 서비스가 v2 OpenStack Images API를 준수하는 등록된 엔드포인트의 요청에 응답합니다.

참고:

가능한 값은 다음과 같습니다.

관련 옵션:

enable_v2_registry = True

부울 값

(DEPRECATED FOR REMOVAL) v2 API 레지스트리 서비스를 배포합니다.

이 옵션이 True 로 설정되면 Glance에서 v2 API 요청에 대해 레지스트리 서비스가 활성화됩니다.

참고:

가능한 값은 다음과 같습니다.

관련 옵션:

enabled_import_methods = ['glance-direct', 'web-download', 'copy-image']

목록 값

fatal_deprecations = False

부울 값

사용 중단의 치명적인 상태를 활성화하거나 비활성화합니다.

hashing_algorithm = sha512

문자열 값

os_hash_value 속성을 계산하는 데 사용되는 보안 해시 알고리즘.

이 옵션은 os_hash_ algo와 os_hash_ value라는 두 개의 이미지 속성으로 구성된 Glance "multihash "를 구성합니다. os_hash_algo 는 이 구성 옵션의 값으로 채워지고, 업로드되거나 가져온 이미지 데이터에 알고리즘이 적용되면 계산된 hexdigest에 의해 os_hash_value 가 채워집니다.

값은 python hash lib 라이브러리에서 인식하는 유효한 보안 해시 알고리즘 이름이어야 합니다. Glance 설치에서 사용되는 라이브러리 버전의 hashlib.algorithms_available 데이터 멤버를 검사하여 이러한 항목을 확인할 수 있습니다. 그러나 상호 운용성을 위해 모든 플랫폼에서 hash lib.algorithms_guaranteed 데이터 멤버가 제공하는 보안 해시 이름 집합을 사용하는 것이 좋습니다. 이러한 알고리즘은 모든 플랫폼에서 hashlib 라이브러리에 의해 지원되도록 보장되기 때문입니다. 따라서 로컬에서 hashlib 를 사용하는 모든 이미지 소비자는 이미지의 os_hash_value 를 확인할 수 있어야 합니다.

sha512 의 기본값은 performant 보안 해시 알고리즘입니다.

이 옵션을 잘못 구성하면 이미지 데이터 저장 시도가 실패합니다. 따라서 기본값을 사용하는 것이 좋습니다.

가능한 값은 다음과 같습니다.

관련 옵션:

image_location_quota = 10

정수 값

이미지에 허용되는 최대 위치 수입니다.

음수 값은 무제한으로 해석됩니다.

관련 옵션:

image_member_quota = 128

정수 값

이미지당 최대 이미지 멤버 수.

이렇게 하면 에서 이미지를 공유할 수 있는 최대 사용자 수가 제한됩니다. 음수 값은 무제한으로 해석됩니다.

관련 옵션:

image_property_quota = 128

정수 값

이미지에 허용되는 최대 속성 수입니다.

이렇게 하면 이미지가 보유할 수 있는 추가 속성 수에 상한이 적용됩니다. 음수 값은 무제한으로 해석됩니다.

관련 옵션:

image_size_cap = 1099511627776

정수 값

사용자가 바이트 단위로 업로드할 수 있는 최대 이미지 크기입니다.

여기에 언급된 크기보다 큰 이미지 업로드로 인해 이미지 생성이 실패합니다. 이 구성 옵션의 기본값은 1099511627776바이트(1TiB)입니다.

참고:

가능한 값은 다음과 같습니다.

image_tag_quota = 128

정수 값

이미지에 허용되는 최대 태그 수입니다.

음수 값은 무제한으로 해석됩니다.

관련 옵션:

'instance_format = [instance: %(uuid)s] '

문자열 값

로그 메시지와 함께 전달되는 인스턴스의 형식입니다.

`instance_uuid_format = [instance: %(uuid)s] `

문자열 값

로그 메시지와 함께 전달되는 인스턴스 UUID의 형식입니다.

limit_param_default = 25

정수 값

요청에 대해 반환할 기본 결과 수입니다.

목록 이미지와 같은 특정 API 요청에 대한 응답은 여러 항목을 반환할 수 있습니다. 반환된 결과 수는 API 요청에 limit 매개변수를 지정하여 명시적으로 제어할 수 있습니다. 그러나 limit 매개변수가 지정되지 않은 경우 이 구성 값은 API 요청에 대해 반환할 결과의 기본 수로 사용됩니다.

참고:

가능한 값은 다음과 같습니다.

관련 옵션:

log-config-append = None

문자열 값

로깅 구성 파일의 이름입니다. 이 파일은 기존 로깅 구성 파일에 추가됩니다. 로깅 구성 파일에 대한 자세한 내용은 Python 로깅 모듈 설명서를 참조하십시오. 로깅 구성 파일을 사용할 때 모든 로깅 구성은 구성 파일에 설정되고 기타 로깅 구성 옵션은 무시됩니다(예: log-date-format).

log-date-format = %Y-%m-%d %H:%M:%S

문자열 값

로그 레코드에서 %%(asctime)의 형식 문자열을 정의합니다. 기본값: %(기본값) . log_config_append가 설정된 경우 이 옵션은 무시됩니다.

log-dir = 없음

문자열 값

(선택 사항) 상대 log_file 경로에 사용되는 기본 디렉터리입니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다.

log-file = 없음

문자열 값

(선택 사항) 로깅 출력을 보낼 로그 파일의 이름입니다. 기본값이 설정되지 않은 경우 로깅은 use_stderr에서 정의한 대로 stderr로 이동합니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다.

log_rotate_interval = 1

정수 값

로그 파일이 순환되기 전의 시간입니다. log_rotation_type이 setto "interval"인 경우 이 옵션은 무시됩니다.

log_rotate_interval_type = days

문자열 값

회전 간격 유형입니다. 마지막 파일 변경 시간(또는 서비스가 시작된 시간)은 다음 순환을 예약할 때 사용됩니다.

log_rotation_type = none

문자열 값

로그 회전 유형.

logging_context_format_string = %(asctime)s.%(msecs)03d %(프로세스)d %(levelname)s %(name)s [%(request_id)s %(user_identity)s] %(instance)s%(message)s

문자열 값

컨텍스트에서 로그 메시지에 사용할 포맷 문자열입니다. oslo_log.formatters.ContextFormatter에서 사용합니다.

logging_debug_format_suffix = %(funcName)s %(pathname)s:%(lineno)d

문자열 값

메시지의 로깅 수준이 DEBUG이면 로그 메시지에 추가할 추가 데이터입니다. oslo_log.formatters.ContextFormatter에서 사용합니다.

logging_default_format_string = %(asctime)s.%(msecs)03d %(process)d %(levelname)s %(name)s [-] %(instance)s%(message)s

문자열 값

컨텍스트가 정의되지 않은 경우 로그 메시지에 사용할 형식 문자열입니다. oslo_log.formatters.ContextFormatter에서 사용합니다.

logging_exception_prefix = %(asctime)s.%(msecs)03d %(process)d ERROR %(name)s %(instance)s

문자열 값

각 줄의 예외 출력에 이 형식을 접두사로 지정합니다. oslo_log.formatters.ContextFormatter에서 사용합니다.

logging_user_identity_format = %(사용자)s %(테넌트)s %(domain)s %(user_domain)s %(project_domain)s

문자열 값

logging_context_format_string에 사용되는 %(user_identity)s의 형식 문자열을 정의합니다. oslo_log.formatters.ContextFormatter에서 사용합니다.

max_logfile_count = 30

정수 값

순환된 로그 파일의 최대 수입니다.

max_logfile_size_mb = 200

정수 값

로그 파일 최대 크기(MB). "log_rotation_type"이 "size"로 설정되지 않은 경우 이 옵션은 무시됩니다.

metadata_encryption_key = 없음

문자열 값

저장 위치 메타데이터 암호화를 위한 AES 키입니다.

Glance 저장소 메타데이터 암호화에 사용할 AES 암호를 나타내는 문자열 값을 제공합니다.

가능한 값은 다음과 같습니다.

관련 옵션:

node_staging_uri = file:///tmp/staging/

문자열 값

URL은 임시 데이터가 저장될 위치를 제공합니다.

이 옵션은 Glance 내부용입니다. Glance는 사용자가 업로드한 이미지 데이터를 이미지 가져오기 프로세스 중에 스테이징 엔드포인트에 저장합니다.

이 옵션은 어떤 방법으로 스테이징 API 엔드포인트를 변경하지 않습니다.

가능한 값은 다음과 같습니다.

관련 옵션:

publish_errors = False

부울 값

오류 이벤트 게시를 활성화하거나 비활성화합니다.

pydev_worker_debug_host = None

호스트 주소 값

pydev 서버의 호스트 주소입니다.

디버깅에 사용할 pydev 서버의 호스트 이름 또는 IP를 나타내는 문자열 값을 제공합니다. pydev 서버는 이 주소에서 디버그 연결을 수신 대기하므로 Glance에서 원격 디버깅이 가능합니다.

가능한 값은 다음과 같습니다.

관련 옵션:

pydev_worker_debug_port = 5678

포트 값

pydev 서버가 수신 대기할 포트 번호입니다.

pydev 서버를 바인딩할 포트 번호를 제공합니다. pydev 프로세스는 이 포트에서 디버그 연결을 수락하고 Glance에서 원격 디버깅을 용이하게 합니다.

가능한 값은 다음과 같습니다.

관련 옵션:

rate_limit_burst = 0

정수 값

rate_limit_interval당 최대 기록 메시지 수.

rate_limit_except_level = CRITICAL

문자열 값

속도 제한에 사용되는 로그 수준 이름: CRITICAL, ERROR, INFO, WARNING, DEBUG 또는 빈 문자열. rate_limit_except_level보다 크거나 같은 로그는 필터링되지 않습니다. 빈 문자열은 모든 레벨이 필터링되었음을 나타냅니다.

rate_limit_interval = 0

정수 값

로그 속도 제한 간격, 초 수입니다.

복원 = 없음

문자열 값

pending_delete 에서 active 로 이미지 상태를 복원합니다.

이 옵션은 관리자가 실수로 이미지가 삭제될 때 pending_delete 에서 이미지 상태를 active 로 재설정하는 데 사용되며 Glance에서 보류 중인 삭제 기능이 활성화됩니다. 이미지 데이터의 불일치를 방지하기 위해 이미지를 복원하기 전에 glance-scrubber 데몬이 중지되었는지 확인하십시오.

가능한 값은 다음과 같습니다.

scrub_pool_size = 1

정수 값

이미지를 스크럽하는 데 사용할 스레드 풀의 크기입니다.

스크럽할 이미지가 많은 경우 스크럽 큐가 계속 제어되고 백엔드 스토리지를 적시에 회수하도록 병렬로 이미지를 제거하는 것이 좋습니다. 이 구성 옵션은 동시에 스크럽할 최대 이미지 수를 나타냅니다. 기본값은 직렬 스크럽을 나타내는 1입니다. 위의 값은 병렬 스크럽을 나타냅니다.

가능한 값은 다음과 같습니다.

관련 옵션:

scrub_time = 0

정수 값

이미지 스크럽을 지연하는 시간(초)입니다.

지연된 삭제가 켜지면 스크럽이 이미지 데이터를 삭제할 때까지 이미지가 삭제 시 pending_delete 상태가 됩니다. 일반적으로 이미지가 pending_delete 상태가 된 직후 스크럽할 수 있습니다. 그러나 이 구성 옵션을 사용하여 나중에 스크럽을 수행할 때까지 스크럽을 지연할 수 있습니다. 이 옵션은 이미지가 스크럽에 사용할 수 있기 전에 pending_delete 상태로 사용하는 기간을 나타냅니다.

스토리지에 영향을 미치는 것이 중요합니다. 스크럽 시간이 클수록 삭제된 이미지에서 백엔드 스토리지를 회수하는 데 시간이 오래 걸립니다.

가능한 값은 다음과 같습니다.

관련 옵션:

show_image_direct_url = False

부울 값

이미지를 반환할 때 직접 이미지 위치를 표시합니다.

이 구성 옵션은 사용자에게 이미지 세부 정보를 반환할 때 직접 이미지 위치를 표시할지 여부를 나타냅니다. 직접 이미지 위치는 이미지 데이터가 백엔드 스토리지에 저장되는 위치입니다. 이 이미지 위치는 image 속성 direct_url 아래에 표시됩니다.

이미지에 대한 여러 이미지 위치가 있으면 구성 옵션 location_strategy 로 표시된 위치 전략을 기반으로 최상의 위치가 표시됩니다.

참고:

가능한 값은 다음과 같습니다.

관련 옵션:

show_multiple_locations = False

부울 값

(DEPRECATED FOR REMOVAL) 이미지를 반환할 때 모든 이미지 위치를 표시합니다.

이 구성 옵션은 이미지 세부 정보를 사용자에게 반환할 때 모든 이미지 위치를 표시할지 여부를 나타냅니다. 이미지에 대한 여러 이미지 위치가 있는 경우 위치는 구성 opt location_strategy 로 표시된 위치 전략을 기반으로 정렬됩니다. 이미지 위치는 image 속성 위치에 표시됩니다.

참고:

가능한 값은 다음과 같습니다.

관련 옵션:

syslog-log-facility = LOG_USER

문자열 값

로그 라인을 수신하는 Syslog 기능. log_config_append가 설정된 경우 이 옵션은 무시됩니다.

use-journal = False

부울 값

로깅을 위해 journald를 활성화합니다. systemd 환경에서 실행되는 경우 저널 지원을 활성화할 수 있습니다. 이렇게 하면 로그 메시지 외에도 구조화된 메타데이터를 포함하는 저널 네이티브 프로토콜을 사용합니다.이 옵션은 log_config_append가 설정된 경우 무시됩니다.

use-json = False

부울 값

로깅을 위해 JSON 포맷을 사용합니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다.

use-syslog = False

부울 값

로깅을 위해 syslog를 사용합니다. 기존 syslog 형식은 DEPRECATED이며 나중에 RFC5424를 적용하도록 변경됩니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다.

use_eventlog = False

부울 값

Windows 이벤트 로그에 로그 출력.

use_stderr = False

부울 값

출력을 표준 오류에 기록합니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다.

user_storage_quota = 0

문자열 값

테넌트당 최대 이미지 스토리지 용량.

이렇게 하면 모든 저장소에서 테넌트의 모든 이미지가 사용하는 누적 스토리지의 상한값이 적용됩니다. 이는 테넌트별 제한입니다.

이 구성 옵션의 기본 단위는 바이트입니다. 그러나 스토리지 단위는 Bytes, KiloBytes,Bytes, GigaBytes 및 TeraBytes를 각각 나타내는 대소문자 B,KB,MB,GB 및 TB 를 사용하여 지정할 수 있습니다. 값과 유닛 사이에는 공백이 없어야 합니다. 값 0 은 할당량 적용을 의미하지 않음을 나타냅니다. 음수 값이 잘못되어 오류가 발생합니다.

가능한 값은 다음과 같습니다.

관련 옵션:

wakeup_time = 300

정수 값

데몬 모드에서 스크럽 실행 간격(초)입니다.

Scrubber는 cron 작업 또는 데몬으로 실행할 수 있습니다. 데몬으로 실행할 때 이 구성 시간은 두 개의 실행 기간을 지정합니다. 스크럽이 중지되면 스크럽을 고려한 후 스크럽에 사용할 수 있는 모든 pending _delete 이미지를 가져와서 스크럽합니다.

Wakeup 시간이 많은 수로 설정된 경우 각 실행에 대해 많은 수의 이미지를 스크럽할 수 있습니다. 또한 백엔드 스토리지를 회수하는 속도에도 영향을 미칩니다.

가능한 값은 다음과 같습니다.

관련 옵션:

watch-log-file = False

부울 값

파일 시스템을 감시하도록 설계된 로깅 핸들러를 사용합니다. 로그 파일이 이동되거나 제거되면 이 핸들러는 지정된 경로를 사용하여 새 로그 파일을 즉시 엽니다. log_file 옵션이 지정되고 Linux 플랫폼이 사용되는 경우에만 의미가 있습니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다.