第3章 Service Registry 設定リファレンス


この章では、Service Registry で利用可能な設定オプションに関する参考情報を提供します。

関連情報

3.1. Service Registry 設定オプション

次の Service Registry 設定オプションは、コンポーネントカテゴリーごとに利用できます。

== 設定オプション

Expand
名前デフォルト利用可能:説明

apicurio.app.date

string

 

3.0.4

 

apicurio.app.description

string

 

3.0.4

 

apicurio.app.name

string

 

3.0.4

 

apicurio.app.version

string

 

3.0.4

 

3.1.1. api

Expand
表3.1 API 設定オプション
名前デフォルト利用可能:説明

apicurio.api.errors.include-stack-in-response

boolean

false

2.1.4.Final

エラー応答にスタックトレースを含める

apicurio.apis.v3.base-href

string

_

2.5.0.Final

API ベースの href (URI)

apicurio.disable.apis

optional<list<string>>

 

2.0.0.Final

API の無効化

3.1.2. auth

Expand
表3.2 認証設定オプション
名前デフォルト利用可能:説明

apicurio.auth.admin-override.claim

string

org-admin

2.1.0.Final

認証管理者オーバーライドクレーム

apicurio.auth.admin-override.claim-value

string

true

2.1.0.Final

認証管理者オーバーライドクレーム値

apicurio.auth.admin-override.enabled

boolean

false

2.1.0.Final

有効化されている認証管理者オーバーライド

apicurio.auth.admin-override.from

string

token

2.1.0.Final

認証管理者オーバーライド:

apicurio.auth.admin-override.role

string

sr-admin

2.1.0.Final

認証管理者オーバーライドロール

apicurio.auth.admin-override.type

string

role

2.1.0.Final

認証管理者オーバーライドタイプ

apicurio.auth.admin-override.user

string

admin

3.0.0

認証管理者オーバーライドユーザー名

apicurio.auth.anonymous-read-access.enabled

boolean [dynamic]

false

2.1.0.Final

匿名の読み取りアクセス

apicurio.auth.authenticated-read-access.enabled

boolean [dynamic]

false

2.1.4.Final

認証された読み取りアクセス

apicurio.auth.owner-only-authorization

boolean [dynamic]

false

2.0.0.Final

アーティファクト所有者のみの承認

apicurio.auth.owner-only-authorization.limit-group-access

boolean [dynamic]

false

2.1.0.Final

アーティファクトグループ所有者のみの承認

apicurio.auth.role-based-authorization

boolean

false

2.1.0.Final

ロールベース認可の有効化

apicurio.auth.role-source

string

token

2.1.0.Final

認証ロールソース

apicurio.auth.role-source.header.name

string

 

2.4.3.Final

ヘッダー認可名

apicurio.auth.roles.admin

string

sr-admin

2.0.0.Final

認証ロール管理者

apicurio.auth.roles.developer

string

sr-developer

2.1.0.Final

認証ロール開発者

apicurio.auth.roles.readonly

string

sr-readonly

2.1.0.Final

認証ロール読み取り専用

apicurio.authn.audit.log.prefix

string

audit

2.2.6

アプリケーション監査ロギングに使用される接頭辞。

apicurio.authn.basic-client-credentials.cache-expiration

integer

10

2.2.6.Final

デフォルトのクライアントクレデンシャルトークンの有効期限(分単位)。

apicurio.authn.basic-client-credentials.cache-expiration-offset

integer

10

2.5.9.Final

JWT の有効期限からのクライアントクレデンシャルトークンの有効期限オフセット(秒単位)。

apicurio.authn.basic-client-credentials.enabled

boolean [dynamic]

false

2.1.0.Final

Basic 認証クライアント認証情報の有効化。

apicurio.authn.basic.scope

optional<string>

 

2.5.0.Final

クライアント認証情報のスコープ。

quarkus.http.auth.basic

boolean

false

3.0.0

Basic 認証を有効にします。

quarkus.oidc.client-id

string

 

2.0.0.Final

サーバーが認証に使用するクライアント ID。

quarkus.oidc.client-secret

optional<string>

 

2.1.0.Final

サーバーが認証に使用するクライアントシークレット。

quarkus.oidc.tenant-enabled

boolean

false

2.0.0.Final

認証を有効にします。

quarkus.oidc.token-path

string

 

2.1.0.Final

認証サーバートークンエンドポイント。

3.1.3. cache

Expand
表3.3 キャッシュ設定オプション
名前デフォルト利用可能:説明

apicurio.config.cache.enabled

boolean

true

2.2.2.Final

有効化されているレジストリーキャッシュ

3.1.4. ccompat

Expand
表3.4 ccompat 設定オプション
名前デフォルト利用可能:説明

apicurio.ccompat.group-concat.enabled

boolean

false

2.6.2.Final

件名の連結によるグループサポートを有効にする (互換性 API)

apicurio.ccompat.group-concat.separator

string

:

2.6.2.Final

グループ連結が有効な場合に使用する区切り文字 (互換性 API)

apicurio.ccompat.legacy-id-mode.enabled

boolean [dynamic]

false

2.0.2.Final

レガシー ID モード (互換 API)

apicurio.ccompat.max-subjects

integer [dynamic]

1000

2.4.2.Final

返されるサブジェクトの最大数 (互換性 API)

apicurio.ccompat.use-canonical-hash

boolean [dynamic]

false

2.3.0.Final

正規ハッシュモード (互換性 API)

3.1.5. download

Expand
表3.5 設定オプションのダウンロード
名前デフォルト利用可能:説明

apicurio.download.href.ttl.seconds

long [dynamic]

30

2.1.2.Final

ダウンロードリンクの有効期限

3.1.6. gitops

Expand
表3.6 gitops 設定オプション
名前デフォルト利用可能:説明

apicurio.gitops.id

string

 

3.0.0

このレジストリーインスタンスの識別子。この識別子を参照するデータのみが読み込まれます。

apicurio.gitops.repo.origin.branch

string

main

3.0.0

ロードするデータを含む、リモート Git リポジトリー内のブランチの名前。

apicurio.gitops.repo.origin.uri

string

 

3.0.0

読み込むデータを含む、リモート git リポジトリーの URI。

apicurio.gitops.workdir

string

/tmp/apicurio-registry-gitops

3.0.0

ローカル Git リポジトリーの保存に使用される GitOps 作業ディレクトリーへのパス。

3.1.7. health

Expand
表3.7 ヘルス設定オプション
名前デフォルト利用可能:説明

apicurio.liveness.errors.ignored

optional<list<string>>

 

1.2.3.Final

無視された liveness エラー

apicurio.metrics.persistence-exception-liveness-check.counter-reset-window-duration.seconds

integer

60

1.0.2.Final

永続性 liveness チェックのカウンターリセットウィンドウの期間

apicurio.metrics.persistence-exception-liveness-check.error-threshold

integer

1

1.0.2.Final

永続性の liveness チェックのエラーしきい値

apicurio.metrics.persistence-exception-liveness-check.logging.disabled

boolean

false

2.0.0.Final

永続性の liveness チェックのロギングの無効化

apicurio.metrics.persistence-exception-liveness-check.status-reset-window-duration.seconds

integer

300

1.0.2.Final

永続 liveness チェックのステータスリセットウィンドウの期間

apicurio.metrics.persistence-timeout-readiness-check.error-threshold

integer

5

1.0.2.Final

永続性 readiness チェックのエラーしきい値

apicurio.metrics.persistence-timeout-readiness-check.timeout.seconds

integer

15

1.0.2.Final

永続性 readiness チェックのタイムアウト

apicurio.metrics.persitence-timeout-readiness-check.status-reset-window-duration.seconds

integer

300

1.0.2.Final

永続性 readiness チェックのステータスリセットウィンドウの期間

apicurio.metrics.resonse-error-liveness-check.counter-reset-window-duration.seconds

integer

60

1.0.2.Final

応答 liveness チェックのカウンターリセットウィンドウの期間

apicurio.metrics.response-error-liveness-check.counter-reset-window-duration.seconds

integer

60

1.0.2.Final

永続性の readiness チェックのカウンターリセットウィンドウの期間

apicurio.metrics.response-error-liveness-check.disabled

boolean

false

2.0.0.Final

応答 liveness チェックのロギングの無効化

apicurio.metrics.response-error-liveness-check.error-threshold

integer

1

1.0.2.Final

応答 liveness チェックのエラーしきい値

apicurio.metrics.response-error-liveness-check.status-reset-window-duration.seconds

integer

300

1.0.2.Final

応答 liveness チェックのステータスリセットウィンドウの期間

apicurio.metrics.response-timeout-readiness-check.counter-reset-window-duration.seconds

instance<integer>

60

1.0.2.Final

応答 readiness チェックのカウンターリセットウィンドウの期間

apicurio.metrics.response-timeout-readiness-check.error-threshold

instance<integer>

1

1.0.2.Final

応答 readiness チェックのエラーしきい値

apicurio.metrics.response-timeout-readiness-check.timeout.seconds

instance<integer>

10

1.0.2.Final

応答 readiness チェックのタイムアウト

apicurio.metrics.response-timeout-rediness-check.status-reset-window-duration.seconds

instance<integer>

300

1.0.2.Final

応答 readiness チェックのステータスリセットウィンドウの期間

apicurio.storage.metrics.cache.check-period.ms

long

30000

2.1.0.Final

ストレージメトリクスキャッシュチェック期間

3.1.8. import

Expand
表3.8 設定オプションのインポート
名前デフォルト利用可能:説明

apicurio.import.preserveContentId

boolean

true

3.0.0

true に設定すると、インポートファイルのコンテンツ ID が使用されます (それ以外の場合は新しい ID が生成されます)。デフォルトは 'true' です。

apicurio.import.preserveGlobalId

boolean

true

3.0.0

true に設定すると、インポートファイルのグローバル ID が使用されます (それ以外の場合は新しい ID が生成されます)。デフォルトは 'true' です。

apicurio.import.requireEmptyRegistry

boolean

true

3.0.0

true に設定すると、レジストリーが空の場合にのみデータのインポートが機能します。デフォルトは 'true' です。

apicurio.import.url

optional<url>

 

2.1.0.Final

インポート URL

apicurio.import.work-dir

string

 

3.0.0

データをインポートするときに使用する一時作業ディレクトリー。

3.1.9. limits

Expand
表3.9 制限設定オプション
名前デフォルト利用可能:説明

apicurio.limits.config.max-artifact-labels

long

-1

2.2.3.Final

最大アーティファクトラベル

apicurio.limits.config.max-artifact-properties

long

-1

2.1.0.Final

最大アーティファクトプロパティー

apicurio.limits.config.max-artifacts

long

-1

2.1.0.Final

最大アーティファクト

apicurio.limits.config.max-description-length

long

-1

2.1.0.Final

最大アーティファクトの説明の長さ

apicurio.limits.config.max-label-size.bytes

long

-1

2.1.0.Final

最大アーティファクトラベルサイズ

apicurio.limits.config.max-name-length

long

-1

2.1.0.Final

最大アーティファクト名の長さ

apicurio.limits.config.max-property-key-size.bytes

long

-1

2.1.0.Final

最大アーティファクトプロパティーのキーサイズ

apicurio.limits.config.max-property-value-size.bytes

long

-1

2.1.0.Final

最大アーティファクトプロパティー値のサイズ

apicurio.limits.config.max-requests-per-second

long

-1

2.2.3.Final

1 秒あたりの最大アーティファクトリクエスト

apicurio.limits.config.max-schema-size.bytes

long

-1

2.2.3.Final

最大スキーマサイズ (バイト)

apicurio.limits.config.max-total-schemas

long

-1

2.1.0.Final

最大合計スキーマ

apicurio.limits.config.max-versions-per-artifact

long

-1

2.1.0.Final

アーティファクトごとの最大バージョン

apicurio.storage.metrics.cache.max-size

long

1000

2.4.1.Final

ストレージメトリクスキャッシュの最大サイズ

3.1.10. リダイレクト

Expand
表3.10 リダイレクト設定オプション
名前デフォルト利用可能:説明

apicurio.redirects

map<string, string>

 

2.1.2.Final

レジストリーのリダイレクト

apicurio.redirects.enabled

boolean

 

2.1.2.Final

リダイレクトの有効化

apicurio.url.override.host

optional<string>

 

2.5.0.Final

外部からアクセス可能な URL の生成に使用されるホスト名をオーバーライドします。ホストとポートのオーバーライドは、HTTPS パススルー Ingress または Route を使用してレジストリーをデプロイするときに役立ちます。このような場合、リクエストはプロキシーされるため、リダイレクトに再利用されるリクエスト URL (およびポート) は、クライアントが使用する実際の外部 URL には属しません。ターゲット URL に到達できないため、リダイレクトは失敗します。

apicurio.url.override.port

optional<integer>

 

2.5.0.Final

外部からアクセス可能な URL の生成に使用されるポートを上書きします。

3.1.11. rest

Expand
表3.11 rest 設定オプション
名前デフォルト利用可能:説明

apicurio.rest.artifact.download.max-size.bytes

int

1000000

2.2.6

URL からダウンロードできるアーティファクトの最大サイズ

apicurio.rest.artifact.download.ssl-validation.disabled

boolean

false

2.2.6

URL からアーティファクトをダウンロードする際に SSL 検証をスキップする

apicurio.rest.deletion.artifact-version.enabled

boolean [dynamic]

false

2.4.2

アーティファクトバージョンの削除を有効化する

apicurio.rest.deletion.artifact.enabled

boolean [dynamic]

false

3.0.0

アーティファクトの削除を有効にする

apicurio.rest.deletion.group.enabled

boolean [dynamic]

false

3.0.0

グループの削除を有効にする

apicurio.rest.mutability.artifact-version-content.enabled

boolean [dynamic]

false

3.0.2

アーティファクトのバージョン変更を有効にする

apicurio.rest.search-results.labels.max-size.bytes

int

512

3.0.3

検索結果内の項目ごとのラベルの最大サイズ (バイト単位)

3.1.12. semver

Expand
表3.12 semver 設定オプション
名前デフォルト利用可能:説明

apicurio.semver.branching.coerce

boolean [dynamic]

false

3.0.0

true の場合、無効なバージョンは、可能であればセマンティックバージョニング 2 形式 (https://semver.org) に強制変換されます。

apicurio.semver.branching.enabled

boolean [dynamic]

false

3.0.0

メジャー ('A.x') およびマイナー ('A.B.x') アーティファクトバージョンのブランチを自動的に作成または更新します。

apicurio.semver.validation.enabled

boolean [dynamic]

false

3.0.0

すべてのアーティファクトバージョンがセマンティックバージョニング 2 形式 (https://semver.org) に準拠していることを検証します。

3.1.13. storage

Expand
表3.13 ストレージ設定オプション
名前デフォルト利用可能:説明

apicurio.datasource.blue.db-kind

string

h2

3.0.0

Gitops blue データソース DB の種類

apicurio.datasource.blue.jdbc.initial-size

string

20

3.0.0

gitOps blue データソースプールの初期サイズ

apicurio.datasource.blue.jdbc.max-size

string

100

3.0.0

gitops blue データソースプールの最大サイズ

apicurio.datasource.blue.jdbc.min-size

string

20

3.0.0

gitops blue データソースプールの最小サイズ

apicurio.datasource.blue.jdbc.url

string

jdbc:h2:mem:registry_db

3.0.0

gitops blue データソース JDBC URL

apicurio.datasource.blue.password

string

sa

3.0.0

gitops blue データソースのパスワード

apicurio.datasource.blue.username

string

sa

3.0.0

gitops blue データソースのユーザー名

apicurio.datasource.green.db-kind

string

h2

3.0.0

GITOPS green データベースの db の種類

apicurio.datasource.green.jdbc.initial-size

string

20

3.0.0

gitops green データソースプールの初期サイズ

apicurio.datasource.green.jdbc.max-size

string

100

3.0.0

gitops green データソースプールの最大サイズ

apicurio.datasource.green.jdbc.min-size

string

20

3.0.0

gitops green データソースプールの最小サイズ

apicurio.datasource.green.jdbc.url

string

jdbc:h2:mem:registry_db

3.0.0

gitops green データソース JDBC URL

apicurio.datasource.green.password

string

sa

3.0.0

gitops green データソースパスワード

apicurio.datasource.green.username

string

sa

3.0.0

gitops green データソースユーザー名

apicurio.events.kafka.topic

string

registry-events

 

ストレージイベントトピック

apicurio.kafkasql.bootstrap.servers

string

  

Kafka sql ストレージブートストラップサーバー

apicurio.kafkasql.consumer.group-prefix

string

apicurio-

 

コンシューマーグループ名の Kafka sql ストレージ接頭辞

apicurio.kafkasql.consumer.poll.timeout

integer

5000

 

Kafka sql ストレージコンシューマーのポーリングタイムアウト

apicurio.kafkasql.coordinator.response-timeout

integer

30000

 

Kafka sql ストレージのコーディネーターの応答タイムアウト

apicurio.kafkasql.security.protocol

optional<string>

  

Kafka sql ストレージのセキュリティープロトコル

apicurio.kafkasql.security.sasl.client-id

string

  

Kafka sql ストレージの sasl クライアント識別子

apicurio.kafkasql.security.sasl.client-secret

string

  

Kafka sql ストレージの sasl クライアントシークレット

apicurio.kafkasql.security.sasl.enabled

boolean

false

 

Kafka sql ストレージの sasl が有効かどうか

apicurio.kafkasql.security.sasl.login.callback.handler.class

string

  

Kafka sql ストレージの sasl ログインコールバックハンドラー

apicurio.kafkasql.security.sasl.mechanism

string

  

Kafka sql ストレージの sasl メカニズム

apicurio.kafkasql.security.sasl.token.endpoint

string

  

Kafka sql ストレージの sasl トークンエンドポイント

apicurio.kafkasql.security.ssl.truststore.location

optional<string>

  

Kafka SQL ストレージの ssl トラストストアの場所

apicurio.kafkasql.security.ssl.truststore.type

optional<string>

  

Kafka SQL ストレージの ssl トラストストアタイプ

apicurio.kafkasql.snapshot.every.seconds

string

86400s

3.0.0

Kafka sql ジャーナルトピックのスナップショット

apicurio.kafkasql.snapshots.topic

string

kafkasql-snapshots

3.0.0

Kafka sql ストレージトピック名

apicurio.kafkasql.ssl.key.password

optional<string>

  

Kafka sql ストレージ ssl キーパスワード

apicurio.kafkasql.ssl.keystore.location

optional<string>

  

Kafka sql ストレージの ssl キーストアの場所

apicurio.kafkasql.ssl.keystore.password

optional<string>

  

Kafka sql ストレージの ssl キーストアパスワード

apicurio.kafkasql.ssl.keystore.type

optional<string>

  

Kafka sql ストレージの ssl キーストアタイプ

apicurio.kafkasql.ssl.truststore.password

optional<string>

  

Kafka sql ストレージの ssl トラストストアパスワード

apicurio.kafkasql.topic

string

kafkasql-journal

 

Kafka sql ストレージトピック名

apicurio.kafkasql.topic.auto-create

boolean

true

 

Kafka sql ストレージのトピックの自動作成

apicurio.sql.db-schema

string

*

3.0.6

データベーススキーマ名(複数のスキーマで同じデータベースに対してレジストリーの 2 つのインスタンスを実行する場合のみ必要)

apicurio.sql.init

boolean

true

2.0.0.Final

SQL init

apicurio.storage.kind

string

 

3.0.0

アプリケーションストレージバリアント (sql、kafkasql、gitops など)

apicurio.storage.read-only.enabled

boolean [dynamic]

false

2.5.0.Final

レジストリーストレージの読み取り専用モードを有効にします。

apicurio.storage.snapshot.location

string

./

3.0.0

Kafka sql スナップショットストアの場所

apicurio.storage.sql.kind

string

h2

3.0.0

アプリケーションデータソースのデータベースタイプ

artifacts.skip.disabled.latest

boolean

true

2.4.2

最新のアーティファクトバージョンを取得する際の DISABLED 状態のアーティファクトバージョンをスキップする

3.1.14. ui

Expand
表3.14 ui 設定オプション
名前デフォルト利用可能:説明

apicurio.ui.auth.oidc.client-id

string

apicurio-registry-ui

3.0.0

OIDC clientId

apicurio.ui.auth.oidc.logout-url

string

f5

3.0.0

OIDC ログアウト URL

apicurio.ui.auth.oidc.redirect-uri

string

/

3.0.0

OIDC redirectUri

apicurio.ui.auth.oidc.scope

string

OpenID プロファイルの email

3.0.8

UI 認証 OIDC スコープの値

apicurio.ui.contextPath

string

/

3.0.0

UI のコンテキストパス

apicurio.ui.docsUrl

string

/docs/

3.0.0

Documentation コンポーネントの URL

apicurio.ui.features.breadcrumbs

string

true

3.0.0

UI でブレッドクラムを表示できるかどうか

apicurio.ui.features.read-only.enabled

string

false

3.0.0

UI を読み取り専用モードに設定できるかどうか

apicurio.ui.features.settings

string

true

3.0.0

UI に設定タブを表示できるかどうか

apicurio.ui.navPrefixPath

string

/

3.0.0

すべての UI パスのナビゲーション接頭辞

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る