Kubernetes-providerreferens för Azure App Configuration

Artikel
04/19/2024

Följande referens beskriver de egenskaper som stöds av Kubernetes-providern v1.3.0för Azure App Configuration . Mer information om ändringen finns i viktig information .

Egenskaper

En AzureAppConfigurationProvider resurs har följande underordnade egenskaper på den översta nivån under spec. Antingen endpoint eller connectionStringReference måste anges.

Name	beskrivning	Obligatoriskt	Typ
slutpunkt	Slutpunkten för Azure App Configuration, som du vill hämta nyckelvärdena från.	alternativ	sträng
connectionStringReference	Namnet på Kubernetes Secret som innehåller Azure App Configuration niska veze.	alternativ	sträng
replicaDiscoveryEnabled	Inställningen som avgör om repliker av Azure App Configuration identifieras automatiskt och används för redundans. Om egenskapen saknas används standardvärdet `true` för .	falskt	bool
mål	Målet för de hämtade nyckelvärdena i Kubernetes.	true	objekt
författare	Autentiseringsmetoden för åtkomst till Azure App Configuration.	falskt	objekt
konfiguration	Inställningarna för att fråga och bearbeta nyckelvärden i Azure App Configuration.	falskt	objekt
hemlighet	Inställningarna för Key Vault-referenser i Azure App Configuration.	villkorlig	objekt
featureFlag	Inställningarna för funktionsflaggor i Azure App Configuration.	falskt	objekt

Egenskapen spec.target har följande underordnade egenskap.

Name	beskrivning	Obligatoriskt	Typ
configMapName	Namnet på den ConfigMap som ska skapas.	true	sträng
configMapData	Inställningen som anger hur hämtade data ska fyllas i i den genererade ConfigMap.	falskt	objekt

Om egenskapen spec.target.configMapData inte har angetts fylls den genererade ConfigMap i med listan över nyckelvärden som hämtats från Azure App Configuration, vilket gör att ConfigMap kan användas som miljövariabler. Uppdatera den här egenskapen om du vill använda ConfigMap som en monterad fil. Den här egenskapen har följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
type	Inställningen som anger hur hämtade data konstrueras i den genererade ConfigMap. De tillåtna värdena är `default`, `json`och `propertiesyaml` .	valfri	sträng
key	Nyckelnamnet för hämtade data när `type` är inställt på `json`, `yaml` eller `properties`. Ange filnamnet om ConfigMap har konfigurerats för att användas som en monterad fil.	villkorlig	sträng
separator	Avgränsare som används för att mata ut ConfigMap-data i hierarkiskt format när typen är inställd på `json` eller `yaml`. Avgränsaren är tom som standard och den genererade ConfigMap innehåller nyckelvärden i sitt ursprungliga formulär. Konfigurera endast den här inställningen om den konfigurationsfilinläsare som används i ditt program inte kan läsa in nyckelvärden utan att konvertera dem till det hierarkiska formatet.	valfri	sträng

Egenskapen spec.auth krävs inte om niska veze i appkonfigurationsarkivet tillhandahålls genom att ange spec.connectionStringReference egenskapen. Annars används en av identiteterna, tjänstens huvudnamn, arbetsbelastningsidentitet eller hanterad identitet för autentisering. Har spec.auth följande underordnade egenskaper. Endast en av dem ska anges. Om ingen av dem anges används den systemtilldelade hanterade identiteten för vm-skalningsuppsättningen.

Name	beskrivning	Obligatoriskt	Typ
servicePrincipalReference	Namnet på Den Kubernetes-hemlighet som innehåller autentiseringsuppgifterna för ett huvudnamn för tjänsten. Hemligheten måste finnas i samma namnrymd som Kubernetes-providern.	falskt	sträng
workloadIdentity	Inställningarna för att använda arbetsbelastningsidentitet.	falskt	objekt
managedIdentityClientId	Klient-ID för användartilldelad hanterad identitet för VM-skalningsuppsättning.	falskt	sträng

Egenskapen spec.auth.workloadIdentity har följande underordnade egenskaper. En av dem måste anges.

Name	beskrivning	Obligatoriskt	Typ
managedIdentityClientId	Klient-ID för den användartilldelade hanterade identiteten som är associerad med arbetsbelastningsidentiteten.	alternativ	sträng
managedIdentityClientIdReference	Klient-ID:t för den användartilldelade hanterade identiteten kan hämtas från en ConfigMap. ConfigMap måste finnas i samma namnrymd som Kubernetes-providern.	alternativ	objekt

Egenskapen spec.auth.workloadIdentity.managedIdentityClientIdReference har följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
configMap	Namnet på ConfigMap där klient-ID:t för en användartilldelad hanterad identitet finns.	true	sträng
key	Nyckelnamnet som innehåller värdet för klient-ID:t för en användartilldelad hanterad identitet.	true	sträng

Har spec.configuration följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
Väljare	Listan över väljare för nyckel/värde-filtrering.	falskt	objektmatris
trimKeyPrefixes	Listan över nyckelprefix som ska trimmas.	falskt	strängmatris
uppdatera	Inställningarna för att uppdatera nyckelvärden från Azure App Configuration. Om egenskapen saknas uppdateras inte nyckelvärdena från Azure App Configuration.	falskt	objekt

Om egenskapen spec.configuration.selectors inte har angetts laddas alla nyckelvärden utan etikett ned. Den innehåller en matris med väljareobjekt som har följande underordnade egenskaper. Observera att nyckelvärdena för den senaste väljaren har företräde och åsidosätter eventuella överlappande nycklar från föregående väljare.

Name	beskrivning	Obligatoriskt	Typ
keyFilter	Nyckelfiltret för att köra frågor mot nyckelvärden. Den här egenskapen och egenskapen `snapshotName` bör inte anges samtidigt.	alternativ	sträng
labelFilter	Etikettfiltret för att köra frågor mot nyckelvärden. Den här egenskapen och egenskapen `snapshotName` bör inte anges samtidigt.	falskt	sträng
snapshotName	Namnet på en ögonblicksbild som nyckelvärden läses in från. Den här egenskapen ska inte användas tillsammans med andra egenskaper.	alternativ	sträng

Egenskapen spec.configuration.refresh har följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
enabled	Inställningen som avgör om nyckelvärden från Azure App Configuration uppdateras automatiskt. Om egenskapen saknas används standardvärdet `false` för .	falskt	bool
övervakning	Nyckelvärdena som övervakas för ändringsidentifiering, t.ex. sentinel-nycklar. Nyckelvärdena från Azure App Configuration uppdateras endast om minst ett av de övervakade nyckelvärdena ändras.	true	objekt
interval	Det intervall med vilket nyckelvärdena uppdateras från Azure App Configuration. Den måste vara större än eller lika med 1 sekund. Om egenskapen saknas används standardvärdet 30 sekunder.	falskt	varaktighetssträng

spec.configuration.refresh.monitoring.keyValues är en matris med objekt som har följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
key	Nyckeln för ett nyckelvärde.	true	sträng
label	Etiketten för ett nyckelvärde.	falskt	sträng

Egenskapen spec.secret har följande underordnade egenskaper. Det krävs om några Key Vault-referenser förväntas laddas ned. Mer information om stöd för inbyggda Kubernetes-typer av hemligheter finns i Typer av hemlighet.

Name	beskrivning	Obligatoriskt	Typ
mål	Målet för de hämtade hemligheterna i Kubernetes.	true	objekt
författare	Autentiseringsmetoden för åtkomst till Key Vaults.	falskt	objekt
uppdatera	Inställningarna för att uppdatera data från Key Vaults. Om egenskapen saknas uppdateras inte data från Key Vaults om inte motsvarande Key Vault-referenser läses in igen.	falskt	objekt

Egenskapen spec.secret.target har följande underordnade egenskap.

Name	beskrivning	Obligatoriskt	Typ
secretName	Namnet på Den Kubernetes-hemlighet som ska skapas.	true	sträng

Om egenskapen spec.secret.auth inte har angetts används den systemtilldelade hanterade identiteten. Den har följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
servicePrincipalReference	Namnet på Kubernetes Secret som innehåller autentiseringsuppgifterna för ett tjänsthuvudnamn som används för autentisering med Key Vaults som inte har angett enskilda autentiseringsmetoder.	falskt	sträng
workloadIdentity	Inställningarna för den arbetsbelastningsidentitet som används för autentisering med Key Vaults som inte har enskilda autentiseringsmetoder angivna. Den har samma underordnade egenskaper som `spec.auth.workloadIdentity`.	falskt	objekt
managedIdentityClientId	Klient-ID för en användartilldelad hanterad identitet för vm-skalningsuppsättning som används för autentisering med Key Vaults som inte har angett enskilda autentiseringsmetoder.	falskt	sträng
keyVaults	Autentiseringsmetoderna för enskilda Key Vaults.	falskt	objektmatris

Autentiseringsmetoden för varje Key Vault kan anges med följande egenskaper. En av managedIdentityClientId, servicePrincipalReference eller workloadIdentity måste anges.

Name	beskrivning	Obligatoriskt	Typ
uri	URI:n för ett Key Vault.	true	sträng
servicePrincipalReference	Namnet på Kubernetes Secret som innehåller autentiseringsuppgifterna för ett tjänsthuvudnamn som används för autentisering med ett Key Vault.	falskt	sträng
workloadIdentity	Inställningarna för den arbetsbelastningsidentitet som används för autentisering med ett Key Vault. Den har samma underordnade egenskaper som `spec.auth.workloadIdentity`.	falskt	objekt
managedIdentityClientId	Klient-ID för en användartilldelad hanterad identitet för vm-skalningsuppsättning som används för autentisering med ett Key Vault.	falskt	sträng

Egenskapen spec.secret.refresh har följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
enabled	Inställningen som avgör om data från Key Vaults uppdateras automatiskt. Om egenskapen saknas används standardvärdet `false` för .	falskt	bool
interval	Intervallet då data uppdateras från Key Vault. Den måste vara större än eller lika med 1 minut. Key Vault-uppdateringen är oberoende av appkonfigurationsuppdateringen som konfigurerats via `spec.configuration.refresh`.	true	varaktighetssträng

Egenskapen spec.featureFlag har följande underordnade egenskaper. Det krävs om några funktionsflaggor förväntas laddas ned.

Name	beskrivning	Obligatoriskt	Typ
Väljare	Listan över väljare för funktionsflaggafiltrering.	falskt	objektmatris
uppdatera	Inställningarna för att uppdatera funktionsflaggor från Azure App Configuration. Om egenskapen saknas uppdateras inte funktionsflaggor från Azure App Configuration.	falskt	objekt

Om egenskapen spec.featureFlag.selectors inte har angetts laddas inte funktionsflaggor ned. Den innehåller en matris med väljareobjekt som har följande underordnade egenskaper. Observera att funktionsflaggor för den senaste väljaren har företräde och åsidosätter eventuella överlappande nycklar från föregående väljare.

Name	beskrivning	Obligatoriskt	Typ
keyFilter	Nyckelfiltret för att fråga efter funktionsflaggor. Den här egenskapen och egenskapen `snapshotName` bör inte anges samtidigt.	alternativ	sträng
labelFilter	Etikettfiltret för att fråga efter funktionsflaggor. Den här egenskapen och egenskapen `snapshotName` bör inte anges samtidigt.	falskt	sträng
snapshotName	Namnet på en ögonblicksbild som funktionsflaggor läses in från. Den här egenskapen ska inte användas tillsammans med andra egenskaper.	alternativ	sträng

Egenskapen spec.featureFlag.refresh har följande underordnade egenskaper.

Name	beskrivning	Obligatoriskt	Typ
enabled	Inställningen som avgör om funktionsflaggor från Azure App Configuration uppdateras automatiskt. Om egenskapen saknas används standardvärdet `false` för .	falskt	bool
interval	Det intervall med vilket funktionsflaggor uppdateras från Azure App Configuration. Den måste vara större än eller lika med 1 sekund. Om egenskapen saknas används standardvärdet 30 sekunder.	falskt	varaktighetssträng

Installation

Använd följande helm install kommando för att installera Kubernetes-providern för Azure App Configuration. Se helm-values.yaml för den fullständiga listan över parametrar och deras standardvärden. Du kan åsidosätta standardvärdena genom att skicka --set flaggan till kommandot .

helm install azureappconfiguration.kubernetesprovider \
    oci://mcr.microsoft.com/azure-app-configuration/helmchart/kubernetes-provider \
    --namespace azappconfig-system \
    --create-namespace

Automatisk skalning

Som standard inaktiveras automatisk skalning. Men om du har flera AzureAppConfigurationProvider resurser för att skapa flera ConfigMaps/Secrets kan du aktivera horisontell automatisk skalning av poddar genom att ange autoscaling.enabled till true.

Exempel

Autentisering

Använda systemtilldelad hanterad identitet för VM-skalningsuppsättning

Aktivera den systemtilldelade hanterade identiteten i vm-skalningsuppsättningen som används av AKS-klustret (Azure Kubernetes Service).
Bevilja rollen systemtilldelad hanterad identitetsappkonfigurationsdataläsare i Azure App Configuration.

Distribuera följande exempelresurs AzureAppConfigurationProvider till AKS-klustret.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider

Använda användartilldelad hanterad identitet för VM-skalningsuppsättning

Skapa en användartilldelad hanterad identitet och anteckna dess klient-ID när du har skapat den.
Tilldela den användartilldelade hanterade identiteten till vm-skalningsuppsättningen som används av AKS-klustret (Azure Kubernetes Service).
Bevilja rollen användartilldelad hanterad identitet appkonfigurationsdataläsare i Azure App Configuration.

spec.auth.managedIdentityClientId Ange egenskapen till klient-ID för den användartilldelade hanterade identiteten i följande exempelresurs AzureAppConfigurationProvider och distribuera den till AKS-klustret.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  auth:
    managedIdentityClientId: <your-managed-identity-client-id>

Använda tjänstens huvudnamn

Skapa ett tjänsthuvudkonto
Ge tjänstens huvudnamn rollen App Configuration Data Reader i Azure App Configuration.
Skapa en Kubernetes-hemlighet i samma namnområde som resursen AzureAppConfigurationProvider och lägg till azure_client_id, azure_client_secret och azure_tenant_id av tjänstens huvudnamn i hemligheten.

spec.auth.servicePrincipalReference Ange egenskapen till namnet på hemligheten i följande exempelresurs AzureAppConfigurationProvider och distribuera den till Kubernetes-klustret.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  auth:
    servicePrincipalReference: <your-service-principal-secret-name>

Använda arbetsbelastningsidentitet

Aktivera arbetsbelastningsidentitet i AKS-klustret (Azure Kubernetes Service).
Hämta URL:en för OIDC-utfärdaren för AKS-klustret.
Skapa en användartilldelad hanterad identitet och anteckna dess klient-ID när du har skapat den.

Skapa den federerade identitetsautentiseringsuppgiften mellan den hanterade identiteten, OIDC-utfärdaren och ämnet med hjälp av Azure CLI.

az identity federated-credential create --name "${FEDERATED_IDENTITY_CREDENTIAL_NAME}" --identity-name "${USER_ASSIGNED_IDENTITY_NAME}" --resource-group "${RESOURCE_GROUP}" --issuer "${AKS_OIDC_ISSUER}" --subject system:serviceaccount:azappconfig-system:az-appconfig-k8s-provider --audience api://AzureADTokenExchange

Bevilja rollen användartilldelad hanterad identitet appkonfigurationsdataläsare i Azure App Configuration.

spec.auth.workloadIdentity.managedIdentityClientId Ange egenskapen till klient-ID för den användartilldelade hanterade identiteten i följande exempelresurs AzureAppConfigurationProvider och distribuera den till AKS-klustret.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  auth:
    workloadIdentity:
      managedIdentityClientId: <your-managed-identity-client-id>

Använda niska veze

Skapa en Kubernetes-hemlighet i samma namnområde som resursen AzureAppConfigurationProvider och lägg till Azure App Configuration-niska veze med nyckeln azure_app_configuration_connection_string i hemligheten.

spec.connectionStringReference Ange egenskapen till namnet på hemligheten i följande exempelresurs AzureAppConfigurationProvider och distribuera den till Kubernetes-klustret.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  connectionStringReference: <your-connection-string-secret-name>
  target:
    configMapName: configmap-created-by-appconfig-provider

Val av nyckelvärde

Använd egenskapen selectors för att filtrera de nyckelvärden som ska laddas ned från Azure App Configuration.

Följande exempel laddar ned alla nyckelvärden utan etikett.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider

I följande exempel används två väljare för att hämta två uppsättningar nyckelvärden, var och en med unika etiketter. Observera att värdena för den senaste väljaren har företräde och åsidosätter eventuella överlappande nycklar från föregående väljare.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  configuration:
    selectors:
      - keyFilter: app1*
        labelFilter: common
      - keyFilter: app1*
        labelFilter: development

En ögonblicksbild kan användas ensam eller tillsammans med andra nyckel/värde-väljare. I följande exempel läser du in nyckelvärden för gemensam konfiguration från en ögonblicksbild och åsidosätter sedan några av dem med nyckelvärden för utveckling.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  configuration:
    selectors:
      - snapshotName: app1_common_configuration
      - keyFilter: app1*
        labelFilter: development

Trimning av nyckelprefix

I följande exempel används trimKeyPrefixes egenskapen för att trimma två prefix från nyckelnamn innan du lägger till dem i den genererade ConfigMap.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  configuration:
    trimKeyPrefixes: [prefix1, prefix2]

Konfigurationsuppdatering

När du gör ändringar i dina data i Azure App Configuration kanske du vill att ändringarna ska uppdateras automatiskt i Kubernetes-klustret. Det är vanligt att uppdatera flera nyckelvärden, men du vill inte att klustret ska hämta en ändring halvvägs genom uppdateringen. För att upprätthålla konfigurationskonsekvensen kan du använda ett nyckelvärde för att signalera att uppdateringen har slutförts. Det här nyckelvärdet kallas sentinel-nyckeln. Kubernetes-providern kan övervaka det här nyckelvärdet och ConfigMap och Hemligheten återskapas endast med uppdaterade data när en ändring har identifierats i sentinel-nyckeln.

I följande exempel avsöks ett nyckelvärde med namnet app1_sentinel varje minut och konfigurationen uppdateras när ändringar identifieras i sentinel-nyckeln.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  configuration:
    selectors:
      - keyFilter: app1*
        labelFilter: common
    refresh:
      enabled: true
      interval: 1m
      monitoring:
        keyValues:
          - key: app1_sentinel
            label: common

Key Vault-referenser

Autentisering

I följande exempel autentiseras ett Key Vault med tjänstens huvudnamn, medan alla andra Nyckelvalv autentiseras med en användartilldelad hanterad identitet.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  configuration:
    selectors:
      - keyFilter: app1*
  secret:
    target:
      secretName: secret-created-by-appconfig-provider
    auth:
      managedIdentityClientId: <your-user-assigned-managed-identity-client-id>
      keyVaults:
        - uri: <your-key-vault-uri>
          servicePrincipalReference: <name-of-secret-containing-service-principal-credentials>

Typer av hemlighet

Två inbyggda Kubernetes-typer av hemligheter, Opaque och TLS, stöds för närvarande. Hemligheter som matchas från Key Vault-referenser sparas som ogenomskinlig hemlighetstyp som standard. Om du har en Key Vault-referens till ett certifikat och vill spara det som TLS-hemlighetstyp kan du lägga till en tagg med följande namn och värde i Key Vault-referensen i Azure App Configuration. På så sätt genereras en hemlighet med kubernetes.io/tls typen och namnges efter nyckeln i Key Vault-referensen.

Name	Värde
.kubernetes.secret.type	kubernetes.io/tls

Uppdatering av hemligheter från Key Vault

Uppdatering av hemligheter från Key Vaults kräver vanligtvis att motsvarande Key Vault-referenser läses in igen från Azure App Configuration. Med egenskapen spec.secret.refresh kan du dock uppdatera hemligheterna från Key Vault oberoende av varandra. Detta är särskilt användbart för att säkerställa att din arbetsbelastning automatiskt hämtar uppdaterade hemligheter från Key Vault under hemlig rotation. Observera att key vault-referensen inte får vara en versionshemlighet om du vill läsa in den senaste versionen av en hemlighet.

Följande exempel uppdaterar alla icke-versioner av hemligheter från Key Vault varje timme.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
  configuration:
    selectors:
      - keyFilter: app1*
        labelFilter: common
  secret:
    target:
      secretName: secret-created-by-appconfig-provider
    auth:
      managedIdentityClientId: <your-user-assigned-managed-identity-client-id>
    refresh:
      enabled: true
      interval: 1h

Funktionsflaggor

I följande exempel laddas funktionsflaggor med nycklar som börjar med app1 och etiketter som motsvarar common ned och uppdateras var 10:e minut. Observera att om du vill fylla i funktionsflaggor i den genererade ConfigMap configMapData.type måste egenskapen vara json eller yaml.

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
    configMapData:
      type: json
      key: appSettings.json
  featureFlag:
    selectors:
      - keyFilter: app1*
        labelFilter: common
    refresh:
      enabled: true
      interval: 10m

ConfigMap-förbrukning

Program som körs i Kubernetes använder vanligtvis ConfigMap antingen som miljövariabler eller som konfigurationsfiler. Om egenskapen configMapData.type saknas eller är inställd på standard fylls ConfigMap i med den specificerade listan över data som hämtats från Azure App Configuration, som enkelt kan användas som miljövariabler. Om egenskapen configMapData.type är inställd på json, yaml eller egenskaper grupperas data som hämtats från Azure App Configuration i ett objekt med nyckelnamnet som anges av configMapData.key egenskapen i den genererade ConfigMap, som kan användas som en monterad fil.

Följande exempel visar hur data fylls i i den genererade ConfigMap med olika inställningar för configMapData.type egenskapen.

Förutsatt att ett App Configuration Store har följande nyckelvärden:

key	värde
key1	value1
nyckel2	value2
key3	value3

Och egenskapen configMapData.type är frånvarande eller inställd på default,

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider

Den genererade ConfigMap fylls i med följande data:

data:
  key1: value1
  key2: value2
  key3: value3

Och egenskapen är inställd på configMapData.type json,

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
    configMapData:
      type: json
      key: appSettings.json

Den genererade ConfigMap fylls i med följande data:

data:
  appSettings.json: >-
    {"key1":"value1","key2":"value2","key3":"value3"}

Och egenskapen är inställd på configMapData.type yaml,

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
    configMapData:
      type: yaml
      key: appSettings.yaml

Den genererade ConfigMap fylls i med följande data:

data:
  appSettings.yaml: >-
    key1: value1
    key2: value2
    key3: value3

Och egenskapen är inställd på configMapData.type properties,

apiVersion: azconfig.io/v1
kind: AzureAppConfigurationProvider
metadata:
  name: appconfigurationprovider-sample
spec:
  endpoint: <your-app-configuration-store-endpoint>
  target:
    configMapName: configmap-created-by-appconfig-provider
    configMapData:
      type: properties
      key: app.properties

Den genererade ConfigMap fylls i med följande data:

data:
  app.properties: >-
    key1=value1
    key2=value2
    key3=value3

Dela via

Kubernetes-providerreferens för Azure App Configuration

Egenskaper

Installation

Automatisk skalning

Exempel

Autentisering

Använda systemtilldelad hanterad identitet för VM-skalningsuppsättning

Använda användartilldelad hanterad identitet för VM-skalningsuppsättning

Använda tjänstens huvudnamn

Använda arbetsbelastningsidentitet

Använda niska veze

Val av nyckelvärde

Trimning av nyckelprefix

Konfigurationsuppdatering

Key Vault-referenser

Autentisering

Typer av hemlighet

Uppdatering av hemligheter från Key Vault

Funktionsflaggor

ConfigMap-förbrukning

Feedback

Ytterligare resurser