Distribution av en enskild dator

Du kan distribuera AKS Edge Essentials på en enskild dator eller på flera datorer. I en kubernetes-distribution med en dator körs både Kubernetes-kontrollnoden och arbetsnoden på samma dator. Den här artikeln beskriver hur du skapar Kubernetes-kontrollnoden på datorn i ett privat nätverk.

Förutsättningar

Konfigurera den primära datorn enligt beskrivningen i Konfigurera dator.

Steg 1: Konfigurationsparametrar för en enskild dator

Generera de parametrar som du behöver för att skapa ett enda datorkluster genom att köra följande kommando:

New-AksEdgeConfig -DeploymentType SingleMachineCluster -outFile .\aksedge-config.json | Out-Null

Det här kommandot skapar en konfigurationsfil med namnet aksedge-config.json som innehåller den konfiguration som krävs för att skapa ett kluster med en enda dator med en Linux-nod. Filen skapas i den aktuella arbetskatalogen. I följande exempel finns fler alternativ för att skapa konfigurationsfilen.

Se JSON-konfiguration för distribution för en detaljerad beskrivning av konfigurationsparametrarna.

Nyckelparametrarna för distribution av en enskild dator är:

  • DeploymentType: Den här parametern definierar distributionstypen. Ange SingleMachineCluster.

  • Arc: Det här avsnittet krävs. Under AKS Edge Essentials-distributionen används Arc-parametrarna för att ansluta AKS Edge Essentials-klustret till Azure Arc. Mer information om nödvändiga Arc-parametrar finns i ansluta till Arc-dokumentationen.

  • Som standard är Network.NetworkPluginflannel. Det här plugin-programmet är standard för ett K3S-kluster. Om du använder ett K8S-kluster ändrar du CNI till calico.

  • Ange följande parametrar enligt distributionskonfigurationen enligt beskrivningen här: LinuxNode.CpuCount, LinuxNode.MemoryInMB, LinuxNode.DataSizeInGB, WindowsNode.CpuCount, WindowsNode.MemoryInMB, Init.ServiceIPRangeSizeoch Network.InternetDisabled.

  • Om du vill kryptera Kubernetes-hemlighetsarkivet aktiverar du plugin-programmet Key Management Service (KMS) (förhandsversion) genom att ange Init.KmsPlugin enable värdet true. Mer information finns i Aktivera hemlig kryptering i ett kluster.

Important

Från och med versionen AKS Edge Essentials 1.10.868.0 krävs avsnittet Arc i konfigurationsfilen. Azure Arc-anslutningen sker automatiskt under AKS Edge Essentials-distributionen.

Steg 2: Skapa ett enskilt datorkluster

Kör cmdleten New-AksEdgeDeployment för att distribuera ett enda maskin AKS Edge-kluster med en enda Linux-kontrollplansnod.

New-AksEdgeDeployment -JsonConfigFilePath .\aksedge-config.json

Important

Kubernetes pod cidr är 10.42.0.0/16 för K3s och 10.244.0.0/24 för K8s. Kubernetes service cidr är 10.43.0.0/16 för K3s och 10.96.0.0/12 för K8s.

Steg 3: Verifiera klustret

Verifiera att distributionen har lyckats genom att köra:

kubectl get nodes -o wide
kubectl get pods -A -o wide

Följande bild visar poddar i ett K3S-kluster:

Skärmbild som visar alla poddar som körs.

Steg 4: Lägg till en Windows-arbetsnod (valfritt)

Caution

Windows-arbetsnoder är en experimentell funktion i den här versionen. Vi arbetar aktivt med den här funktionen.

Om du vill lägga till en Windows-nod i ett befintligt kluster med en enda Linux-dator skapar du först konfigurationsfilen med följande kommando:

New-AksEdgeScaleConfig -ScaleType AddNode -NodeType Windows -outFile .\ScaleConfig.json | Out-Null

Det här kommandot skapar konfigurationsfilen ScaleConfig.json i den aktuella arbetskatalogen. Du kan också ändra Windows-nodparametrarna i konfigurationsfilen för att ange de resurser som du behöver allokera till Windows-noden. Med konfigurationsfilen kör du följande kommando för att lägga till noden i klustret för en enskild dator:

Add-AksEdgeNode -JsonConfigFilePath .\ScaleConfig.json

Exempel på distributionsalternativ

Skapa ett JSON-objekt med konfigurationsparametrarna

Du kan programmatiskt redigera JSON-objektet och skicka det som en sträng:

$jsonObj = New-AksEdgeConfig -DeploymentType SingleMachineCluster
$jsonObj.User.AcceptEula = $true
$jsonObj.User.AcceptOptionalTelemetry = $true
$jsonObj.Init.ServiceIpRangeSize = 10
$machine = $jsonObj.Machines[0]
$machine.LinuxNode.CpuCount = 4
$machine.LinuxNode.MemoryInMB = 4096

New-AksEdgeDeployment -JsonConfigString ($jsonObj | ConvertTo-Json -Depth 4)

Tip

Se JSON-konfiguration för distribution för alla tillgängliga alternativ, inklusive nätverksinställningar som proxyinställningar.

Skapa ett enkelt kluster med NodePort-tjänsten

Du kan skapa ett enkelt kluster utan tjänst-IP-adresser genom att ange ServiceIPRangeSize till 0:

New-AksEdgeDeployment -JsonConfigString (New-AksEdgeConfig | ConvertTo-Json -Depth 4)

Allokera resurser till dina noder

Om du vill ansluta till Arc och distribuera dina appar med GitOps allokerar du fyra processorer eller mer för (processorkraft), LinuxNode.CpuCount 4 GB eller mer för LinuxNode.MemoryinMB (RAM) och tilldelar ett tal som är större än 0 till ServiceIpRangeSize. I följande exempel allokerar du 10 IP-adresser för dina Kubernetes-tjänster:

{
  "SchemaVersion": "1.5",
  "Version": "1.0",
  "DeploymentType": "SingleMachineCluster",
  "Init": {
    "ServiceIPRangeSize": 10
  },
  "Network": {
      "NetworkPlugin": "flannel"
  },
  "User": {
      "AcceptEula": true,
      "AcceptOptionalTelemetry": true
  },
  "Machines": [
       {
         "LinuxNode": {
              "CpuCount": 4,
              "MemoryInMB": 4096
          }
       }
   ]
}

Note

AKS Edge Essentials allokerar IP-adresser från din interna växel för att köra Kubernetes-tjänsterna om du anger en ServiceIPRangeSize.

Du kan också välja att skicka parametrarna som en JSON-sträng enligt beskrivningen ovan:

$jsonObj = New-AksEdgeConfig -DeploymentType SingleMachineCluster
$jsonObj.User.AcceptEula = $true
$jsonObj.User.AcceptOptionalTelemetry = $true
$jsonObj.Init.ServiceIpRangeSize = 10
$machine = $jsonObj.Machines[0]
$machine.LinuxNode.CpuCount = 4
$machine.LinuxNode.MemoryInMB = 4096

New-AksEdgeDeployment -JsonConfigString ($jsonObj | ConvertTo-Json -Depth 4)

Skapa ett blandat arbetsbelastningskluster

Du kan skapa ett kluster med både Linux- och Windows-noder. Använd följande kommando för att skapa konfigurationsfilen:

New-AksEdgeConfig -DeploymentType SingleMachineCluster -NodeType LinuxAndWindows -outFile .\aksedge-config.json | Out-Null

När du har skapat konfigurationsfilen använder du följande kommando för att distribuera klustret:

New-AksEdgeDeployment -JsonConfigFilePath .\aksedge-config.json

Nästa steg

  • Last updated on