3.3. glance-cache.conf
이 섹션에는 /etc/glance/glance-cache.conf 파일에 대한 옵션이 포함되어 있습니다.
3.3.1. 기본값 링크 복사링크가 클립보드에 복사되었습니다!
다음 표에는 /etc/glance/glance-cache.conf 파일의 [DEFAULT] 그룹에서 사용할 수 있는 옵션이 요약되어 있습니다.
.
| 설정 옵션 = 기본값 | 유형 | 설명 |
|---|---|---|
|
| 문자열 값 | (ReMOVAL 관련 사항) 관리자 암호입니다. "use_user_token"이 적용되지 않으면 관리자 자격 증명을 지정할 수 있습니다. |
|
| 문자열 값 | (DEPRECATED FOR REMOVAL) 관리 사용자의 테넌트 이름입니다. "use_user_token"이 적용되지 않으면 관리자 테넌트 이름을 지정할 수 있습니다. |
|
| 문자열 값 | (REMOVAL에 대한 결정) 관리자 사용자 이름입니다. "use_user_token"이 적용되지 않으면 관리자 자격 증명을 지정할 수 있습니다. |
|
| 부울 값 | 사용자가 이미지에 추가/사용자 지정 속성을 추가할 수 있습니다.
Glance는 모든 이미지에 표시되는 표준 속성 집합(고급 스키마)을 정의합니다. 이러한 속성을
기본적으로 이 구성 옵션은 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 정수 값 | 요청에서 반환할 수 있는 최대 결과 수입니다.
참고 이 값을 매우 큰 값으로 설정하면 데이터베이스 쿼리가 느려지고 응답 시간이 증가할 수 있습니다. 이 값을 매우 낮은 값으로 설정하면 사용자 환경이 저하될 수 있습니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | (ReMOVAL 관련 사항) 인증 서비스의 지역입니다. "use_user_token"이 적용되지 않고 keystone auth을 사용하는 경우 지역 이름을 지정할 수 있습니다. |
|
| 문자열 값 | (ReMOVAL 관련 사항) 인증에 사용할 전략입니다. "use_user_token"이 적용되지 않으면 auth 전략을 지정할 수 있습니다. |
|
| 문자열 값 | (ReMOVAL 관련 사항) keystone 서비스에 대한 URL입니다. "use_user_token"이 적용되지 않고 keystone auth을 사용하는 경우 keystone의 URL을 지정할 수 있습니다. |
|
| 문자열 값 | (REMOVAL용(DEPRECATED FOR REMOVAL) 데이터 액세스 API의 Python 모듈 경로입니다. 데이터 모델 액세스에 사용할 API의 경로를 지정합니다. 이 옵션은 이미지 카탈로그 데이터에 액세스하는 방법을 결정합니다. 가능한 값은 다음과 같습니다.
이 옵션이
이 옵션을 참고
v2 OpenStack Images API에서 레지스트리 서비스는 선택 사항입니다. v2에서 레지스트리 API를
마지막으로 이 구성 옵션을 관련 옵션:
|
|
| 부울 값 | true로 설정하면 로깅 수준이 기본 INFO(정보) 수준이 아닌 DEBUG(디버그)로 설정됩니다. |
|
| 목록 값 | logger=LEVEL 쌍의 패키지 로깅 수준 목록입니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 문자열 값 | 디지털 서명에 사용할 다이제스트 알고리즘입니다.
디지털 서명을 생성하는 데 사용할 다이제스트 알고리즘을 나타내는 문자열 값을 제공합니다. 기본적으로
플랫폼에서 OpenSSL 버전에서 지원하는 사용 가능한 알고리즘 목록을 가져오려면 참고
가능한 값은 다음과 같습니다.
관계 옵션:
|
|
| 부울 값 |
|
|
| 부울 값 | v2 OpenStack Images API를 배포합니다.
이 옵션을 참고:
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 부울 값 | (DEPRECATED FOR REMOVAL) v2 API 레지스트리 서비스를 배포합니다.
이 옵션이 참고:
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 목록 값 |
|
|
| 부울 값 | 사용 중단의 치명적인 상태를 활성화하거나 비활성화합니다. |
|
| 문자열 값 | 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 보안 해시 알고리즘입니다. 이 옵션을 잘못 구성하면 이미지 데이터 저장 시도가 실패합니다. 따라서 기본값을 사용하는 것이 좋습니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | 이미지 캐시의 기본 디렉토리.
이미지 데이터가 캐시되고 에서 제공되는 위치입니다. 캐시된 모든 이미지는 이 디렉터리 아래에 직접 저장됩니다. 이 디렉토리에는 세 개의 하위 디렉터리, 즉,
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | 이미지 캐시 관리에 사용할 드라이버입니다. 이 구성 옵션은 사용 가능한 다양한 이미지 캐시 드라이버 중에서 선택할 수 있는 유연성을 제공합니다. 이미지 캐시 드라이버는 캐시에서 이미지에 쓰기/읽기, 캐시된 이미지의 사용 기간 및 사용과 같은 이미지 캐시의 필수 기능을 제공하고, 캐시된 이미지 목록을 제공하고, 캐시 크기를 가져오고, 캐싱을 위한 큐 이미지, 캐시를 정리하는 등의 작업을 담당합니다.
드라이버의 필수 기능은 기본 클래스
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 정수 값 | cache-pruner가 이미지 캐시를 정리한 후 캐시 크기의 상한값(바이트)입니다. 참고 이는 cache-pruner가 작동하는 임계값일 뿐입니다. 이미지 캐시가 확장되지 않는 하드 제한이 아닙니다. 실제로 cache-pruner 실행 빈도와 캐시가 가득 차는 속도에 따라 이미지 캐시가 여기에 지정된 크기를 매우 쉽게 초과할 수 있습니다. 따라서 cache-pruner를 적절하게 예약하고 이 제한을 설정하려면 주의해야 합니다. Glance는 다운로드 시 이미지를 캐시합니다. 결과적으로 다운로드 수가 증가함에 따라 이미지 캐시의 크기가 시간이 지남에 따라 증가합니다. 캐시 크기가 관리 불가능해지는 것을 유지하려면 cache-pruner를 정기적인 작업으로 실행하는 것이 좋습니다. 캐시 정리기가 시작되면 현재 이미지 캐시 크기를 비교하고 여기에 지정된 크기 이상으로 이미지 캐시가 증가하면 정리를 트리거합니다. 정리 후 캐시 크기가 여기에 지정된 크기보다 작거나 같습니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | 이미지 캐시 관리에 사용할 파일 데이터베이스의 상대 경로입니다.
이미지 캐시의 수명 및 사용량 통계를 추적하는 파일 데이터베이스의 상대 경로입니다. 경로는 구성 옵션 이 데이터베이스는 하나의 테이블이 있는 경량 데이터베이스입니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 정수 값 | 시간(초)은 불완전한 이미지가 캐시에 남아 있습니다.
불완전한 이미지는 다운로드가 진행 중인 이미지입니다. 자세한 내용은 설정 옵션 디스크 공간을 차지하지 못하도록 Glance API 노드에서 cache-cleaner를 주기적으로 실행하는 것이 좋습니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 정수 값 | 이미지에 허용되는 최대 위치 수입니다. 음수 값은 무제한으로 해석됩니다. 관련 옵션:
|
|
| 정수 값 | 이미지당 최대 이미지 멤버 수. 이렇게 하면 에서 이미지를 공유할 수 있는 최대 사용자 수가 제한됩니다. 음수 값은 무제한으로 해석됩니다. 관련 옵션:
|
|
| 정수 값 | 이미지에 허용되는 최대 속성 수입니다. 이렇게 하면 이미지가 보유할 수 있는 추가 속성 수에 상한이 적용됩니다. 음수 값은 무제한으로 해석됩니다. 참고
추가 속성을 비활성화하면 영향을 미치지 않습니다. 관련 옵션:
|
|
| 정수 값 | 사용자가 바이트 단위로 업로드할 수 있는 최대 이미지 크기입니다. 여기에 언급된 크기보다 큰 이미지 업로드로 인해 이미지 생성이 실패합니다. 이 구성 옵션의 기본값은 1099511627776바이트(1TiB)입니다. 참고:
가능한 값은 다음과 같습니다.
|
|
| 정수 값 | 이미지에 허용되는 최대 태그 수입니다. 음수 값은 무제한으로 해석됩니다. 관련 옵션:
|
| 'instance_format = [instance: %(uuid)s] ' | 문자열 값 | 로그 메시지와 함께 전달되는 인스턴스의 형식입니다. |
| `instance_uuid_format = [instance: %(uuid)s] ` | 문자열 값 | 로그 메시지와 함께 전달되는 인스턴스 UUID의 형식입니다. |
|
| 정수 값 | 요청에 대해 반환할 기본 결과 수입니다.
목록 이미지와 같은 특정 API 요청에 대한 응답은 여러 항목을 반환할 수 있습니다. 반환된 결과 수는 API 요청에 참고:
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | 로깅 구성 파일의 이름입니다. 이 파일은 기존 로깅 구성 파일에 추가됩니다. 로깅 구성 파일에 대한 자세한 내용은 Python 로깅 모듈 설명서를 참조하십시오. 로깅 구성 파일을 사용할 때 모든 로깅 구성은 구성 파일에 설정되고 기타 로깅 구성 옵션은 무시됩니다(예: log-date-format). |
|
| 문자열 값 | 로그 레코드에서 %%(asctime)의 형식 문자열을 정의합니다. 기본값: %(기본값) . log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 문자열 값 | (선택 사항) 상대 log_file 경로에 사용되는 기본 디렉터리입니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 문자열 값 | (선택 사항) 로깅 출력을 보낼 로그 파일의 이름입니다. 기본값이 설정되지 않은 경우 로깅은 use_stderr에서 정의한 대로 stderr로 이동합니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 정수 값 | 로그 파일이 순환되기 전의 시간입니다. log_rotation_type이 setto "interval"인 경우 이 옵션은 무시됩니다. |
|
| 문자열 값 | 회전 간격 유형입니다. 마지막 파일 변경 시간(또는 서비스가 시작된 시간)은 다음 순환을 예약할 때 사용됩니다. |
|
| 문자열 값 | 로그 회전 유형. |
|
| 문자열 값 | 컨텍스트에서 로그 메시지에 사용할 포맷 문자열입니다. oslo_log.formatters.ContextFormatter에서 사용합니다. |
|
| 문자열 값 | 메시지의 로깅 수준이 DEBUG이면 로그 메시지에 추가할 추가 데이터입니다. oslo_log.formatters.ContextFormatter에서 사용합니다. |
|
| 문자열 값 | 컨텍스트가 정의되지 않은 경우 로그 메시지에 사용할 형식 문자열입니다. oslo_log.formatters.ContextFormatter에서 사용합니다. |
|
| 문자열 값 | 각 줄의 예외 출력에 이 형식을 접두사로 지정합니다. oslo_log.formatters.ContextFormatter에서 사용합니다. |
|
| 문자열 값 | logging_context_format_string에 사용되는 %(user_identity)s의 형식 문자열을 정의합니다. oslo_log.formatters.ContextFormatter에서 사용합니다. |
|
| 정수 값 | 순환된 로그 파일의 최대 수입니다. |
|
| 정수 값 | 로그 파일 최대 크기(MB). "log_rotation_type"이 "size"로 설정되지 않은 경우 이 옵션은 무시됩니다. |
|
| 문자열 값 | 저장 위치 메타데이터 암호화를 위한 AES 키입니다. Glance 저장소 메타데이터 암호화에 사용할 AES 암호를 나타내는 문자열 값을 제공합니다. 참고 사용할 AES 키를 길이가 16, 24 또는 32바이트의 임의 문자열로 설정해야 합니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | URL은 임시 데이터가 저장될 위치를 제공합니다. 이 옵션은 Glance 내부용입니다. Glance는 사용자가 업로드한 이미지 데이터를 이미지 가져오기 프로세스 중에 스테이징 엔드포인트에 저장합니다. 이 옵션은 어떤 방법으로 스테이징 API 엔드포인트를 변경하지 않습니다. 참고 [task]/work_dir과 동일한 경로를 사용하는 것이 좋지 않습니다. 참고 file://<absolute-directory-path>; 는 현재 api_image_import 플로우를 지원하는 유일한 옵션입니다. 참고 스테이징 경로는 모든 Glance API 노드에서 사용할 수 있는 공유 파일 시스템에 있어야 합니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 부울 값 | 오류 이벤트 게시를 활성화하거나 비활성화합니다. |
|
| 호스트 주소 값 | pydev 서버의 호스트 주소입니다. 디버깅에 사용할 pydev 서버의 호스트 이름 또는 IP를 나타내는 문자열 값을 제공합니다. pydev 서버는 이 주소에서 디버그 연결을 수신 대기하므로 Glance에서 원격 디버깅이 가능합니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 포트 값 | pydev 서버가 수신 대기할 포트 번호입니다. pydev 서버를 바인딩할 포트 번호를 제공합니다. pydev 프로세스는 이 포트에서 디버그 연결을 수락하고 Glance에서 원격 디버깅을 용이하게 합니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 정수 값 | rate_limit_interval당 최대 기록 메시지 수. |
|
| 문자열 값 | 속도 제한에 사용되는 로그 수준 이름: CRITICAL, ERROR, INFO, WARNING, DEBUG 또는 빈 문자열. rate_limit_except_level보다 크거나 같은 로그는 필터링되지 않습니다. 빈 문자열은 모든 레벨이 필터링되었음을 나타냅니다. |
|
| 정수 값 | 로그 속도 제한 간격, 초 수입니다. |
|
| 문자열 값 | 인증 기관 파일에 대한 절대 경로입니다. 레지스트리 서버에 대한 보안 연결을 설정하는 데 사용할 인증 기관 파일의 유효한 절대 경로를 나타내는 문자열 값을 제공합니다. 참고
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | (REMOVAL에 대한 결정) 인증서 파일에 대한 절대 경로입니다. 레지스트리 서버에 대한 보안 연결을 설정하는 데 사용할 인증서 파일의 유효한 절대 경로를 나타내는 문자열 값을 제공합니다. 참고
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 부울 값 | (DEPRECATED FOR REMOVAL) 레지스트리 서버 인증서의 확인을 설정합니다.
레지스트리 서버에 대한 SSL 연결의 유효성을 검사할지 여부를 결정하는 부울 값을 제공합니다. 기본적으로 이 옵션은
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | (REMOVAL에 대한 결정) 개인 키 파일의 절대 경로입니다. 레지스트리 서버에 대한 보안 연결을 설정하는 데 사용할 개인 키 파일의 유효한 절대 경로를 나타내는 문자열 값을 제공합니다. 참고
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | 레지스트리 서버와의 통신에 사용할 (DEPRECATED FOR REMOVAL) 프로토콜입니다.
레지스트리 서버와의 통신에 사용할 프로토콜을 나타내는 문자열 값을 제공합니다. 기본적으로 이 옵션은
이 옵션은 레지스트리 서버에 대한 보안 연결을 설정하기 위해 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 정수 값 | (REMOVAL에 대한 결정) 레지스트리 요청에 대한 시간 제한 값입니다. API 서버가 레지스트리 요청이 완료될 때까지 대기하는 시간(초)을 나타내는 정수 값을 제공합니다. 기본값은 600초입니다. 값이 0이면 요청이 시간 초과되지 않습니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 호스트 주소 값 | (REMOVAL에 대한 DEPRECATED) 레지스트리 서버가 호스팅되는 주소입니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 포트 값 | (REMOVAL용DEPRECATED) 레지스트리 서버가 수신 대기 중인 포트입니다. 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 부울 값 | 이미지를 반환할 때 직접 이미지 위치를 표시합니다.
이 구성 옵션은 사용자에게 이미지 세부 정보를 반환할 때 직접 이미지 위치를 표시할지 여부를 나타냅니다. 직접 이미지 위치는 이미지 데이터가 백엔드 스토리지에 저장되는 위치입니다. 이 이미지 위치는 image 속성
이미지에 대한 여러 이미지 위치가 있으면 구성 옵션 참고:
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 부울 값 | (DEPRECATED FOR REMOVAL) 이미지를 반환할 때 모든 이미지 위치를 표시합니다.
이 구성 옵션은 이미지 세부 정보를 사용자에게 반환할 때 모든 이미지 위치를 표시할지 여부를 나타냅니다. 이미지에 대한 여러 이미지 위치가 있는 경우 위치는 구성 opt 참고:
가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 문자열 값 | 로그 라인을 수신하는 Syslog 기능. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 부울 값 | 로깅을 위해 journald를 활성화합니다. systemd 환경에서 실행되는 경우 저널 지원을 활성화할 수 있습니다. 이렇게 하면 로그 메시지 외에도 구조화된 메타데이터를 포함하는 저널 네이티브 프로토콜을 사용합니다.이 옵션은 log_config_append가 설정된 경우 무시됩니다. |
|
| 부울 값 | 로깅을 위해 JSON 포맷을 사용합니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 부울 값 | 로깅을 위해 syslog를 사용합니다. 기존 syslog 형식은 DEPRECATED이며 나중에 RFC5424를 적용하도록 변경됩니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 부울 값 | Windows 이벤트 로그에 로그 출력. |
|
| 부울 값 | 출력을 표준 오류에 기록합니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |
|
| 부울 값 | (DEPRECATED FOR REMOVAL) 레지스트리에 요청할 때 사용자 토큰을 통과할지 여부입니다. 큰 파일 업로드 중에 토큰 만료가 실패하지 않도록 하려면 이 매개변수를 False로 설정하는 것이 좋습니다. "use_user_token"이 적용되지 않으면 관리자 자격 증명을 지정할 수 있습니다. |
|
| 문자열 값 | 테넌트당 최대 이미지 스토리지 용량. 이렇게 하면 모든 저장소에서 테넌트의 모든 이미지가 사용하는 누적 스토리지의 상한값이 적용됩니다. 이는 테넌트별 제한입니다.
이 구성 옵션의 기본 단위는 바이트입니다. 그러나 스토리지 단위는 Bytes, KiloBytes,Bytes, GigaBytes 및 TeraBytes를 각각 나타내는 대소문자 가능한 값은 다음과 같습니다.
관련 옵션:
|
|
| 부울 값 | 파일 시스템을 감시하도록 설계된 로깅 핸들러를 사용합니다. 로그 파일이 이동되거나 제거되면 이 핸들러는 지정된 경로를 사용하여 새 로그 파일을 즉시 엽니다. log_file 옵션이 지정되고 Linux 플랫폼이 사용되는 경우에만 의미가 있습니다. log_config_append가 설정된 경우 이 옵션은 무시됩니다. |