Azure Arc etkin açık hizmet ağı (Önizleme)

Açık hizmet ağı (OSı) , kullanıcıların yüksek düzeyde dinamik mikro hizmet ortamları için kullanıma hazır Observability özelliklerini bir arada yönetmesine, güvenli hale getirmeye ve kullanıma almasına olanak tanıyan basit, Genişletilebilir, bulut Yerel hizmet ağlarından oluşur.

OSD, Kubernetes üzerinde bir Envoy tabanlı denetim düzlemi çalıştırır, SMI API 'lerle yapılandırılabilir ve uygulamanızın her bir örneğinin yanında yer alan bir sepet kapsayıcısı olarak ekleme a Envoy proxy 'si ile çalışır. Açık hizmet ağı tarafından etkinleştirilen hizmet kafesi senaryolarında daha fazla bilgi edinin .

Azure Arc özellikli açık hizmet ağı için destek sınırlamaları

• Azure Arc bağlantılı bir Kubernetes kümesine yalnızca bir adet açık hizmet ağı örneği dağıtılabilir.
• Açık hizmet ağı sürümü v 0.8.4 ve üzeri için genel önizleme kullanılabilir. Sürümün en son sürümünü buradabulabilirsiniz. Desteklenen yayın sürümleri notlarla birlikte eklenir. Ara sürümler ile ilişkili etiketleri yoksayın.
• Şu anda aşağıdaki Kubernetes dağıtımları desteklenmektedir:
  • AKS Engine
  • HCı üzerinde AKS
  • Küme API 'SI Azure
  • Google Kubernetes altyapısı
  • Kurallı Kubernetes dağılımı
  • Ranhi Kubernetes altyapısı
  • OpenShift Kubernetes dağılımı
  • Amazon elastik Kubernetes hizmeti
• Azure Arc özellikli açık hizmet ağı ile Azure Izleyici tümleştirmesi, sınırlı destekile kullanılabilir.

Önkoşullar

• Buradalistelenen küme uzantılarına yönelik tüm ortak önkoşulları karşıladığınızı doğrulayın.
• Az k8s-Extension CLı Version >= v 0.4.0 kullanın

Azure Arc etkin bir Kubernetes kümesine Azure Arc özellikli açık hizmet ağı 'nı (OSD) yükler

Aşağıdaki adımlarda, Azure Arc 'a bağlı desteklenen Kubernetes dağıtımına sahip bir kümeniz zaten var.

Belirli bir OSD sürümünü yükler

KUBECONFIG ortam değişkeninizin, OSD uzantısının yüklenmesini istediğiniz Kubernetes kümesinin KUBECONFIG ' i işaret ettiğini doğrulayın.

Ortam değişkenlerini ayarlayın:

export VERSION=<osm-arc-version>
export CLUSTER_NAME=<arc-cluster-name>
export RESOURCE_GROUP=<resource-group-name>

Azure Arc özellikli açık hizmet ağı önizlemedeyken, az k8s-extension create komut yalnızca pilot bayrak için kabul eder --release-train . --auto-upgrade-minor-version her zaman olarak ayarlanır false ve bir sürüm belirtilmelidir. Bir OpenShift kümeniz varsa, bölümündekiadımları kullanın.

az k8s-extension create --cluster-name $CLUSTER_NAME --resource-group $RESOURCE_GROUP --cluster-type connectedClusters --extension-type Microsoft.openservicemesh --scope cluster --release-train pilot --name osm --version $VERSION

Aşağıda gösterilen çıktıya benzer bir çıktı görmeniz gerekir. Gerçek OSE Held grafiğinin kümeye dağıtılması 3-5 dakika sürebilir. Bu dağıtım gerçekleşene kadar, InstallState ' i bekliyor olarak görmeye devam edersiniz.

{
  "autoUpgradeMinorVersion": false,
  "configurationSettings": {},
  "creationTime": "2021-04-29T17:50:11.4116524+00:00",
  "errorInfo": {
    "code": null,
    "message": null
  },
  "extensionType": "microsoft.openservicemesh",
  "id": "/subscriptions/<subscription-id>/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Kubernetes/connectedClusters/$CLUSTER_NAME/providers/Microsoft.KubernetesConfiguration/extensions/osm",
  "identity": null,
  "installState": "Pending",
  "lastModifiedTime": "2021-04-29T17:50:11.4116525+00:00",
  "lastStatusTime": null,
  "location": null,
  "name": "osm",
  "releaseTrain": "pilot",
  "resourceGroup": "$RESOURCE_GROUP",
  "scope": {
    "cluster": {
      "releaseNamespace": "arc-osm-system"
    },
    "namespace": null
  },
  "statuses": [],
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "version": "x.x.x"
}

OpenShift kümesine belirli bir OSD sürümü yükler

1. Aşağıdaki içerikleri kopyalayın ve bir JSON dosyasına kaydedin. Zaten bir yapılandırma ayarları dosyası oluşturduysanız, önceki değişikliklerinizi korumak için lütfen mevcut dosyaya aşağıdaki satırı ekleyin.

   {
       "osm.OpenServiceMesh.enablePrivilegedInitContainer": "true"
   }
   

   Dosya yolunu bir ortam değişkeni olarak ayarlayın:

   export SETTINGS_FILE=<json-file-path>
   

2. az k8s-extension createOSI uzantısını oluşturmak için kullanılan komutu çalıştırın ve yapılandırma ayarlarını kullanarak ayarlar dosyasını geçirin:

   az k8s-extension create --cluster-name $CLUSTER_NAME --resource-group $RESOURCE_GROUP --cluster-type connectedClusters --extension-type Microsoft.openservicemesh --scope cluster --release-train pilot --name osm --version $VERSION --configuration-settings-file $SETTINGS_FILE
   

3. Ağ üzerindeki uygulamalara yönelik her bir hizmet hesabına ayrıcalıklı güvenlik bağlamı kısıtlaması ekleyin.

   oc adm policy add-scc-to-user privileged -z <service account name> -n <service account namespace>
   

Gerçek OSE Held grafiğinin kümeye dağıtılması 3-5 dakika sürebilir. Bu dağıtım gerçekleşene kadar, InstallState ' i bekliyor olarak görmeye devam edersiniz.

Ayrıcalıklı init kapsayıcı ayarının varsayılana geri döndürülmemesini sağlamak için, "OSM 'yi geçirin. Openservicekafes. Enableprivilegedınitcontainer ":" true "yapılandırma ayarı, sonraki tüm az k8s-Extension Create komutlarına göre yapılır.

ARM şablonunu kullanarak Azure Arc özellikli OSD 'yi yükler

Kümenizi Azure yaya bağladıktan sonra, ve değerlerini güncelleştirdiğinizden emin olmak için aşağıdaki biçimde bir JSON dosyası oluşturun <cluster-name> <osm-arc-version> :

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "ConnectedClusterName": {
            "defaultValue": "<cluster-name>",
            "type": "String",
            "metadata": {
                "description": "The Connected Cluster name."
            }
        },
        "ExtensionInstanceName": {
            "defaultValue": "osm",
            "type": "String",
            "metadata": {
                "description": "The extension instance name."
            }
        },
        "ExtensionVersion": {
            "defaultValue": "<osm-arc-version>",
            "type": "String",
            "metadata": {
                "description": "The extension type version."
            }
        },
        "ExtensionType": {
            "defaultValue": "Microsoft.openservicemesh",
            "type": "String",
            "metadata": {
                "description": "The extension type."
            }
        },
        "ReleaseTrain": {
            "defaultValue": "Pilot",
            "type": "String",
            "metadata": {
                "description": "The release train."
            }
        }
    },
    "functions": [],
    "resources": [
        {
            "type": "Microsoft.KubernetesConfiguration/extensions",
            "apiVersion": "2020-07-01-preview",
            "name": "[parameters('ExtensionInstanceName')]",
            "properties": {
                "extensionType": "[parameters('ExtensionType')]",
                "releaseTrain": "[parameters('ReleaseTrain')]",
                "version": "[parameters('ExtensionVersion')]"
            },
            "scope": "[concat('Microsoft.Kubernetes/connectedClusters/', parameters('ConnectedClusterName'))]"
        }
    ]
}

Şimdi ortam değişkenlerini ayarlayın:

export TEMPLATE_FILE_NAME=<template-file-path>
export DEPLOYMENT_NAME=<desired-deployment-name>

Son olarak, bu komutu çalıştırarak OSı uzantısını az CLı aracılığıyla yüklersiniz:

az deployment group create --name $DEPLOYMENT_NAME --resource-group $RESOURCE_GROUP --template-file $TEMPLATE_FILE_NAME

Artık OSı kaynaklarını görüntüleyebiliyor ve kümenizdeki OSı uzantısını kullanabilmelisiniz.

Azure Arc etkin açık hizmet ağı yüklemesini doğrulama

Aşağıdaki komutu çalıştırın.

az k8s-extension show --cluster-type connectedClusters --cluster-name $CLUSTER_NAME --resource-group $RESOURCE_GROUP --name osm

Aşağıdaki çıktıya benzer bir JSON çıktısı görmeniz gerekir:

{
  "autoUpgradeMinorVersion": false,
  "configurationSettings": {},
  "creationTime": "2021-04-29T19:22:00.7649729+00:00",
  "errorInfo": {
    "code": null,
    "message": null
  },
  "extensionType": "microsoft.openservicemesh",
  "id": "/subscriptions/<subscription-id>/resourceGroups/$RESOURCE_GROUP/providers/Microsoft.Kubernetes/connectedClusters/$CLUSTER_NAME/providers/Microsoft.KubernetesConfiguration/extensions/osm",
  "identity": null,
  "installState": "Installed",
  "lastModifiedTime": "2021-04-29T19:22:00.7649731+00:00",
  "lastStatusTime": "2021-04-29T19:23:27.642+00:00",
  "location": null,
  "name": "osm",
  "releaseTrain": "pilot",
  "resourceGroup": "$RESOURCE_GROUP",
  "scope": {
    "cluster": {
      "releaseNamespace": "arc-osm-system"
    },
    "namespace": null
  },
  "statuses": [],
  "type": "Microsoft.KubernetesConfiguration/extensions",
  "version": "x.x.x"
}

OSA denetleyici yapılandırması

OSD osm-mesh-config , Arc-OSI-System ad alanındaki denetim düzleminin bir parçası olarak bir MeshConfig kaynağı dağıtır. Bu MeshConfig 'in amacı, ağ sahibini/işlecini, ihtiyaçlarına göre bazı ağ yapılandırmalarını güncelleştirebilme olanağı sağlamaktır. varsayılan değerleri görüntülemek için aşağıdaki komutu kullanın.

kubectl describe meshconfig osm-mesh-config -n arc-osm-system

Çıktıda varsayılan değerler gösterilmektedir:

Certificate:
    Service Cert Validity Duration:  24h
  Feature Flags:
    Enable Egress Policy:      true
    Enable Multicluster Mode:  false
    Enable WASM Stats:         true
  Observability:
    Enable Debug Server:  false
    Osm Log Level:        info
    Tracing:
      Address:   jaeger.osm-system.svc.cluster.local
      Enable:    false
      Endpoint:  /api/v2/spans
      Port:      9411
  Sidecar:
    Config Resync Interval:            0s
    Enable Privileged Init Container:  false
    Envoy Image:                       mcr.microsoft.com/oss/envoyproxy/envoy:v1.18.3
    Init Container Image:              mcr.microsoft.com/oss/openservicemesh/init:v0.9.1
    Log Level:                         error
    Max Data Plane Connections:        0
    Resources:
  Traffic:
    Enable Egress:                          false
    Enable Permissive Traffic Policy Mode:  true
    Inbound External Authorization:
      Enable:              false
      Failure Mode Allow:  false
      Stat Prefix:         inboundExtAuthz
      Timeout:             1s
    Use HTTPS Ingress:     false

Daha fazla bilgi için Yapılandırma API başvurusuna bakın. Spec. Traffic. enablePermissiveTrafficPolicyMode 'in true olarak ayarlandığını unutmayın. OSD 'de izin veren trafik ilkesi modu, SMI trafik ilkesi zorlamasının atlanacağı bir moddur. Bu modda, OSA, bu hizmetlerle iletişim kurabilmesi için her bir Envoy ara sunucu arabasının hizmet kafesi ve programlar trafik ilkesi kurallarının bir parçası olan hizmetleri otomatik olarak bulur.

OSD denetleyicisi yapılandırmasında değişiklikler yapılıyor

' De yapılan değişiklikler osm-mesh-config kubectl Patch komutu kullanılarak yapılabilir. Aşağıdaki örnekte, izin veren trafik ilkesi modu false olarak değiştirilmiştir.

kubectl patch meshconfig osm-mesh-config -n arc-osm-system -p '{"spec":{"traffic":{"enablePermissiveTrafficPolicyMode":false}}}' --type=merge

Yanlış bir değer kullanılırsa, MeshConfig CRD 'deki doğrulamalar, değerin neden geçersiz olduğunu belirten bir hata iletisiyle değişikliği engeller. Örneğin, aşağıdaki komut, Enableçıkışı Boole olmayan bir değere yadığımızda ne olacağını gösterir.

kubectl patch meshconfig osm-mesh-config -n arc-osm-system -p '{"spec":{"traffic":{"enableEgress":"no"}}}'  --type=merge

# Validations on the CRD will deny this change
The MeshConfig "osm-mesh-config" is invalid: spec.traffic.enableEgress: Invalid value: "string": spec.traffic.enableEgress in body must be of type boolean: "string"

OSA denetleyici yapılandırması (sürüm v 0.8.4)

Şu anda, ConfigMap aracılığıyla OSA denetleyici yapılandırmasına erişebilir ve bunları yapılandırabilirsiniz. OSı denetleyicisi yapılandırma ayarlarını görüntülemek için, osm-config kubectl yapılandırma ayarlarını görüntülemek üzere configmap 'i aracılığıyla sorgulayın.

kubectl get configmap osm-config -n arc-osm-system -o json

Çıkış:

{
  "egress": "false",
  "enable_debug_server": "false",
  "enable_privileged_init_container": "false",
  "envoy_log_level": "error",
  "permissive_traffic_policy_mode": "true",
  "prometheus_scraping": "true",
  "service_cert_validity_duration": "24h",
  "tracing_enable": "false",
  "use_https_ingress": "false"
}

Kullanılabilir yapılandırmaların her birini anlamak için OSE ConfigMap belgelerini okuyun.

V 0.8.4 için OSı ConfigMap üzerinde değişiklik yapmak için aşağıdaki kılavuzu kullanın:

1. Bir JSON dosyasında yapmak istediğiniz değişiklikleri kopyalayın ve kaydedin. Bu örnekte, permissive_traffic_policy_mode true ' dan false ' a değiştireceğiz. ' De her değişiklik yaptığınızda osm-config , BIR JSON dosyasındaki değişikliklerin tam listesini (varsayılana kıyasla) sağlamanız gerekir osm-config .

   {
       "osm.OpenServiceMesh.enablePermissiveTrafficPolicy" : "false"
   }
   

   Dosya yolunu bir ortam değişkeni olarak ayarlayın:

   export SETTINGS_FILE=<json-file-path>
   

2. az k8s-extension createUzantıyı oluşturmak için kullanılan komutu çalıştırın, ancak şimdi yapılandırma ayarları dosyasını geçirin:

   az k8s-extension create --cluster-name $CLUSTER_NAME --resource-group $RESOURCE_GROUP --cluster-type connectedClusters --extension-type Microsoft.openservicemesh --scope cluster --release-train pilot --name osm --version $VERSION --configuration-settings-file $SETTINGS_FILE
   

   Not

   ConfigMap değişikliklerinin varsayılana geri döndürülmemesini sağlamak için, aynı yapılandırma ayarlarını sonraki az k8s-Extension Create komutlarına geçirin.

Azure Arc özellikli açık hizmet ağı 'nı kullanma

OSı yeteneklerini kullanmaya başlamak için önce uygulama ad alanlarını hizmet ağı 'na eklemeniz gerekir. osmGitHub yayımları sayfasındanosd clı 'yi indirin. Ad alanları kafese eklendikten sonra, istenen OSı özelliğini elde etmek için SMı ilkelerini yapılandırabilirsiniz.

Ad alanlarını hizmet ağı 'na ekleme

Aşağıdaki komutu çalıştırarak ad alanlarını kafese ekleyin:

osm namespace add <namespace_name>

Buradanekleme hizmetleri hakkında daha fazla bilgi bulabilirsiniz.

OSD 'yi hizmet kafesi arabirimi (SMı) ilkeleriyle yapılandırma

Bir demo uygulamasıyla BAŞLAYABILIR veya SMI ilkelerini denemek için test ortamınızı kullanabilirsiniz.

Kendi Jaeger, Prometheus ve Grafana örneklerinizi yapılandırma

OSM uzantısı, kullanıcıların OSM 'yi bu araçların kendi çalışan örnekleri ile tümleştirebilmeleri adına Jaeger, Prometheus ve Grafana gibi eklentileri yüklemez. Kendi örneklerinizi tümleştirmek için aşağıdaki belgelere bakın:

• BYO-Jaeger örneği
• BYO-Prometheus örneği
• BYO-Grafana panosu

Azure izleyici ve uygulamaları kullanarak uygulamayı izleme Analizler

azure izleyici ve azure Application Insights, bulut ve şirket içi ortamlarınızdaki telemetri toplama, çözümleme ve üzerinde işlem yapmaya yönelik kapsamlı bir çözüm sunarak uygulamalarınızın ve hizmetlerinizin kullanılabilirliğini ve performansını en üst düzeye çıkarmanıza yardımcı olur.

Azure Arc özellikli açık hizmet ağı, bu Azure hizmetlerinin her ikisinde de ayrıntılı tümleştirmelere sahip olacak ve OSD ölçümleri tarafından sağlanan kritik KPI 'Ları görüntülemek ve bunlara yanıt vermek için daha az bir Azure deneyimi sağlar. Uygulama ölçümlerinin toplanması için Azure Izleyici 'nin ıskartaya çıkmasına yönelik ABD uç noktalarına izin vermek için aşağıdaki adımları izleyin.

1. İzlenmesini istediğiniz uygulama ad alanlarının ağ için eklendi olduğundan emin olun. Burada bulunanyönergeleri izleyin.

2. Uygulama ad alanları için Prometheus uç noktalarını kullanıma sunun.

   osm metrics enable --namespace <namespace1>
   osm metrics enable --namespace <namespace2>
   

   V 0.8.4 için, prometheus_scraping true configmap içinde olarak ayarlandığından emin olun osm-config .

3. Buradasunulan Kılavuzu kullanarak Azure izleyici uzantısını yükler.

4. Container-AZM-MS-osmconfig ConfigMap içinde izlemek istediğiniz ad alanlarını ekleyin. ConfigMap 'i buradanindirin.

   monitor_namespaces = ["namespace1", "namespace2"]
   

5. Aşağıdaki kubectl komutunu çalıştırın

   kubectl apply -f container-azm-ms-osmconfig.yaml
   

Ölçümlerin Log Analytics görünmesi 15 dakika kadar sürebilir. Insightsölçümlerini tablosunu sorgulamayı deneyebilirsiniz.

InsightsMetrics
| where Name contains "envoy"
| extend t=parse_json(Tags)
| where t.app == "namespace1"

Azure Izleyici ile tümleştirme hakkında buradandaha fazla bilgi edinin.

OSA panosunda gezinme

1. Azure Arc bağlantılı Kubernetes kümenize bu bağlantıyıkullanarak erişin.
2. Azure Izleyici 'ye gidin ve OSM çalışma kitabına erişmek için raporlar sekmesine gidin.
3. Hizmetlerinizin kapsamını belirlemek için zaman aralığı & ad alanını seçin.

İstekler sekmesi

• Bu sekme, OSD 'de hizmete hizmet aracılığıyla gönderilen tüm http isteklerinin özetini sağlar.
• Kılavuzdaki hizmeti seçerek tüm hizmetleri ve iletişim kurduğu tüm hizmetleri görüntüleyebilirsiniz.
• Toplam istekleri görüntüleyebilir, istek hata oranı P90 gecikme süresi &.
• Hedefe gidebilir ve HTTP hatası/başarı kodu, başarı oranı, Pod kaynak kullanımı ve gecikme süreleriyle ilgili eğilimleri farklı yüzdebirlik değeri izleyebilirsiniz.

Bağlantılar sekmesi

• Bu sekme, açık hizmet ağı 'ndaki hizmetleriniz arasındaki tüm bağlantıların özetini sağlar.
• Giden bağlantılar: kaynak ve hedef hizmetler arasındaki toplam bağlantı sayısı.
• Giden etkin bağlantılar: seçili zaman aralığındaki kaynak ve hedef arasındaki en son etkin bağlantı sayısı.
• Giden başarısız bağlantılar: kaynak ve hedef hizmet arasındaki toplam başarısız bağlantı sayısı

OSE uzantı örneğini belirli bir sürüme yükseltme

Yükseltmeler sırasında denetim düzleminin bazı kapalı kalma süresi olabilir. Veri düzlemi yalnızca CRD yükseltmeleri sırasında etkilenecektir.

Desteklenen yükseltmeler

OSE uzantısı bir sonraki alt sürüme yükseltilebilir. Şu anda eski sürüme ve ana sürüm yükseltmeleri desteklenmez.

CRD yükseltmeleri

Bu sürüm, önce var olan CRDs 'yi silmeden, bu sürümde bir CRD sürüm güncelleştirmesi içeriyorsa OSA uzantısı yeni bir sürüme yükseltilemez. OSB Sürüm NOTLARıNıNCRD Updates bölümünü denetleyerek bir OSD YÜKSELTMESININ de CRD sürüm güncelleştirmelerini içerip içermediğiniz kontrol edebilirsiniz.

Yükseltmeden sonra kolayca yeniden oluşturulabilen şekilde, CRDs 'yi silmeden önce özel kaynaklarınızı yedeklediğinizden emin olun. Daha sonra, aşağıda yakalanan yükseltme yönergelerini izleyin.

Yükseltme yönergeleri

1. Eski CRD 'leri ve özel kaynakları silin ( OSK deposununkökünden çalıştırın). OSD CRDs etiketinin grafiğin yeni sürümüne karşılık geldiğinden emin olun.

   kubectl delete --ignore-not-found --recursive -f ./charts/osm/crds/
   
   

2. Install the updated CRDs.

   kubectl apply -f charts/osm/crds/
   

3. Yeni grafik sürümünü bir ortam değişkeni olarak ayarlayın:

   export VERSION=<chart version>
   

4. Yeni grafik sürümüyle az k8s-Extension Create Çalıştır

   az k8s-extension create --cluster-name $CLUSTER_NAME --resource-group $RESOURCE_GROUP --cluster-type connectedClusters --extension-type Microsoft.openservicemesh --scope cluster --release-train pilot --name osm --version $VERSION --configuration-settings-file $SETTINGS_FILE
   

5. Yeni CRD 'leri kullanarak özel kaynakları yeniden oluşturma

Azure Arc özellikli açık hizmet ağı 'nı kaldırma

Aşağıdaki komutu kullanın:

az k8s-extension delete --cluster-type connectedClusters --cluster-name $CLUSTER_NAME --resource-group $RESOURCE_GROUP --name osm -y

Uzantı örneğinin silindiğini doğrulayın:

az k8s-extension list --cluster-type connectedClusters --cluster-name $CLUSTER_NAME --resource-group $RESOURCE_GROUP

Bu çıktı OSD içermemelidir. Kümenizde yüklü başka bir uzantı yoksa, bu yalnızca boş bir dizi olacaktır.

OSM uzantısını silmek için az k8s-Extension komutunu kullandığınızda, Arc-OSM-System ad alanı kaldırılmaz ve ad alanı içindeki gerçek kaynaklar (Web kancası yapılandırmasını ve OSM-Controller Pod 'u değiştirici gibi) silmek yaklaşık 10 dakika sürer.

Sorun giderme

Burada bulunansorun giderme kılavuzuna bakın.

Sonraki adımlar

Yalnızca bir şeyi denemek mi istiyorsunuz?
Küme API 'sini kullanarak bir Azure Arc Jumpstart senaryosu ile hızlı bir şekilde çalışmaya başlayın.