2.2.3. デフォルトのベース URL
Operator は backstage-appconfig-{CR_name} と呼ばれるデフォルトの app-config ConfigMap に Backstage アプリケーションのベース URL を自動的に設定します。Operator は、ルートパラメーターと OpenShift クラスターの Ingress ドメインに基づいてこれを実行します。
Operator は次のルールに従ってアプリケーションのベース URL を設定します。
- クラスターが OpenShift でない場合、Operator は変更を行いません。
-
カスタムリソース (CR) の
spec.application.route.enabledフィールドを明示的にfalseに設定した場合、変更は行われません。 -
Backstage CR で
spec.application.route.hostを定義すると、ベース URL はhttps://<spec.application.route.host>に設定されます。 -
Backstage CR で
spec.application.route.subdomainを指定すると、ベース URL はhttps://<spec.application.route.subdomain>.<cluster_ingress_domain>に設定されます。 -
カスタムホストまたはサブドメインが指定されていない場合、Operator はベース URL を
https://backstage-<cr_name>-<namespace>.<cluster_ingress_domain>に設定します。これは、作成された Route リソースのデフォルトドメインです。
Operator は、デフォルトの app-config ConfigMap 内の次のベース URL を更新します。
-
app.baseUrl -
backend.baseUrl -
backend.cors.origin
注記
これらのアクションはベストエフォート方式で OpenShift 上でのみ実行できます。エラー発生時または OpenShift 以外のクラスターの場合でも、カスタム app-config ConfigMap を提供することでこれらのデフォルトをオーバーライドできます。