Node- und Nodearray-Objekte

Knoten- und Nodearray-Objekte sind Rang 2 und untergeordnet zu cluster. Ein Knoten stellt einen einzelnen virtuellen Computer dar, während ein Knotenarray eine Auflistung virtueller Computer oder mindestens einen Skalierungssatz für virtuelle Computer darstellen kann.

Knotenstandardwerte

Dies [[node defaults]] ist ein spezieller abstrakter Knoten, der die Standardeinstellung für alle Knoten und Knotenarrays in einem Cluster angibt:

[cluster my-cluster]
  [[node defaults]]
  Credentials = $Credentials
  SubnetId = my-rg/my-vnet/my-subnet
  MachineType = Standard_D2s_v3

  [[nodearray grid]]
  ImageName = cycle.image.centos6
  MachineType = Standard_H16

Dies $Credentials ist ein Verweis auf einen Parameter namens "Credentials".

In my-cluster, das grid Nodearray erbt die Anmeldeinformationen und SubnetId vom Knoten defaults, verwendet jedoch eine bestimmte HPC-VM-Größe von Standard_H16.

Beispiel

Diese Beispielvorlage erstellt einen Cluster mit zwei Knoten und einem Knotenarray. Der Proxyknoten verwendet IsReturnProxy, um die spezielle Rolle von ReturnProxy zu definieren, die der Endpunkt für einen Proxy für einen Rückkanal sein wird, der von CycleCloud stammt, wenn der Cluster gestartet wird.

[cluster my-cluster]

  [[node defaults]]
    Credentials = $Credentials
    SubnetId = $SubnetId
    KeyPairLocation = ~/.ssh/cyclecloud.pem
    ImageName = cycle.image.centos7

  [[node proxy]]
    IsReturnProxy = true
    MachineType = Standard_B2

  [[node scheduler]]
    MachineType = Standard_D4s_v3

  [[nodearray execute]]
    MachineType = Standard_D16s_v3

Erforderliche Attributreferenz

Es gibt mindestens vier erforderliche Attribute, um einen Knoten erfolgreich zu starten:

Merkmal	Typ	Definition
Maschinentyp	Schnur	Die Größe des virtuellen Azure-Computers
Subnetz-ID	Schnur	Subnetzdefinition im Formular ${rg}/${vnet}/${subnet}. Beachten Sie, dass dies nicht die vollständige Ressourcen-ID ist.
Anmeldeinformationen	Schnur	Name des Cloudanbieterkontos.

Das vierte erforderliche Attribut ist mit einem Bild verknüpft. Ein Bildattribute ist erforderlich, aber es gibt mehrere Formen, die es übernehmen kann – siehe Bildattribute.

Zusätzliche Attribute

Merkmal	Typ	Definition
ComputerName	Schnur	Computername für vm. Wenn angegeben, überschreibt der vom System generierte Name.
ComputerNamePrefix	Schnur	Präfix vor dem Stift an vom System generierte Computernamen
EphemeralOSDisk	Boolean	Verwenden Sie flüchtigen Startdatenträger für virtuelle Maschine, falls unterstützt
Zone	Zeichenfolge (Liste)	Verfügbarkeitszone für VM oder VMSS. Kann eine Liste für VMSS sein. Z. B. Zone = 1,3
ProximityPlacementGroupId	Schnur	Die vollständige ID für die Näherungsplatzierungsgruppe, in die dieser Knoten gesetzt werden soll. Muss beginnen mit /subscriptions/
PlacementGroupId	Schnur	Bei Festlegung wird diese Bezeichnung verwendet, um diesen Knoten in einer einzelnen Platzierungsgruppe mit allen anderen Knoten zu platzieren, die einen übereinstimmenden Wert für PlacementGroupId aufweisen. Dies bietet eine geringere Latenzkommunikation und ist erforderlich, um InfiniBand auf VM-Größen zu aktivieren, die sie unterstützen. Dies wird in der Regel nach Bedarf vom Scheduler festgelegt, sodass er nicht manuell angegeben werden muss.
KeyPairLocation	Integer	Wo CycleCloud einen SSH-Keypair im lokalen Dateisystem findet
KeepAlive	Boolean	Bei "true" verhindert CycleCloud die Beendigung dieses Knotens.
Locker	Schnur	Geben Sie den Namen des Schließfachs an, aus dem Projektspezifikationen heruntergeladen werden sollen. Siehe Verwenden von Projekten
BootDiagnosticsUri	Schnur	Speicher-URI für die Startdiagnose (Beispiel: https://mystorageaccount.blob.core.windows.net/), falls angegeben. Es gelten Speichergebühren.
HybridBenefit	Boolean	Wenn wahr, erlaubt die Lizenzierung des "Azure Hybrid Benefit" für Windows-VMs
NetworkSecurityGroupId	Schnur	Wenn angegeben, die vollständige Ressourcen-ID für eine Netzwerksicherheitsgruppe, die für diesen Knoten verwendet werden soll. Hinweis: Dies kann auch wie SecurityGroup auf einer Netzwerkschnittstelle angegeben werden.
EnableTerminateNotification (8.2.0+)	Boolean	Falls auf "wahr" gesetzt, ermöglicht "Terminate Notification", dass Ereignisse bei der Löschung eines virtuellen Computers zur lokalen Verarbeitung an den virtuellen Computer gesendet werden können. Dies gilt nur für scaleset-VMs.
TerminateNotificationTimeout (8.2.2+)	Relative Zeit	Wenn die Beendigungsbenachrichtigung aktiviert ist, steuert dies, wie lange VMs bereitgestellt wird, um das Ereignis zu verarbeiten, bevor sie gelöscht werden.
ThrottleCapacity (8.2.2+)	Boolean	Wenn "true" lautet, meldet dieses Nodearray 0 Kapazität für automatischeCaler für einen Standardwert von 5 Minuten, nachdem ein Kapazitätsproblem auftritt.
ThrottleCapacityTime (8.2.2+)	Relative Zeit	Wenn ThrottleCapacity diese Option aktiviert ist, wird angegeben, wie lange die Verfügbarkeit von 0 nach eingeschränkter Kapazität angezeigt wird. Der Standardwert ist "5m".
HybridBenefitLicense (8.3.0+)	Schnur	Ist HybridBenefit "true", gibt dies die zu verwendende Lizenz an: RHEL_BYOS, , SLES_BYOS, oder Windows_Server. Der Standardwert ist Windows_Server.
FlexScaleSetId (8.3.0+)	Schnur	Bei Festlegung ist dies die vollqualifizierte ID eines Scalesets im Flex-Orchestrierungsmodus , der für den virtuellen Computer für diesen Knoten verwendet wird.
EncryptionAtHost (8.4.0+)	Boolean	Bei "true" ist der virtuelle Computer "Verschlüsselung bei Host " aktiviert.
SecurityType (8.5.0+)	Schnur	Legt den Sicherheitstyp fest; entweder nicht definiert oder TrustedLaunchConfidentialVM
EnableSecureBoot (8.5.0+)	Boolean	Aktiviert den sicheren Start, wenn vertrauenswürdige Start-VMs oder vertrauliche VMs verwendet werden.
EnableVTPM (8.5.0+)	Boolean	Aktiviert virtual Trusted Platform Module, wenn Vertrauenswürdige Start-VMs oder vertrauliche VMs verwendet werden.
ScaleSetUpgradePolicyMode (8.6.2+)	Schnur	Gibt die Skalierungssatz-Upgraderichtlinie an, die steuert, was mit vorhandenen virtuellen Computern in einem Skalierungssatz geschieht, wenn die Skalierungssatzvorlage außerhalb von CycleCloud geändert wird. Dies sollte in der Regel aktiviert werden, wenn sie ein automatisiertes Tool zum Ändern vorhandener Skalierungsgruppen verwenden, z. B. Azure-Richtlinie. Hinweis: Dadurch wird das Betriebssystemimage nicht automatisch aktualisiert. Einer von Automatic, Rollingoder Manual (der Standard).

Hinweis

Eine Näherungsplatzierungsgruppe ist ein allgemeines Azure-Feature, das erstellt werden muss, bevor auf einen Knoten verwiesen werden kann. Auf diese Weise können CycleCloud-VMs gemeinsam mit anderen Azure-Ressourcen in dieser Näherungsplatzierungsgruppe platziert werden, ermöglicht jedoch keine InfiniBand-Netzwerke. Im Gegensatz dazu wird PlacementGroupId als eine beliebige Zeichenfolge in CycleCloud verwendet, um VMs für Knoten in einem einzigen Scaleset zu gruppieren, das auf denselben Netzwerkswitch beschränkt ist, aber möglicherweise nicht gemeinsam mit anderen Azure-Ressourcen platziert wird. Sie können beide zusammen verwendet werden, aber dies kann die Anzahl der virtuellen Computer verringern, die zugeordnet werden können.

Bildattribute

Das VM-Image ist eine erforderliche Einstellung zum Starten eines virtuellen Computers. Es gibt drei gültige Formen der Bilddefinition: Standardmäßige CycleCloud-Bildnamen, Marketplace-Bilddefinitionen und Image-IDs.

ImageName

CycleCloud unterstützt eine Reihe von Marketplace-Standardimages, die für verschiedene Betriebssystemvarianten verfügbar sind. Diese können mit einem ImageName angegeben werden.

Merkmal	Typ	Definition
ImageName	Schnur	Name des zyklusgestützten Bilds. cycle.image.[win2016, win2012, centos7, centos6, ubuntu16, ubuntu14]

Marketplace-Bilder

Zusammen mit zyklusverwalteten Marketplace-Images kann jedes beliebige Marketplace-Image verwendet werden, indem Publisher, Offer, Sku und ImageVersion angegeben werden.

Merkmal	Typ	Definition
Azure.Publisher	Schnur	Herausgeber des VM Marketplace-Images
Azure.Offer	Schnur	Angebot für VM Marketplace-Image
Azure.Sku	Schnur	Sku des VM Marketplace-Images
Azure.ImageVersion	Schnur	Bildversion des Marketplace-Images.

Hinweis

Ein Marketplace-Bild kann auch im ImageName Attribut angegeben werden, das als URN im Formular Publisher:Offer:Sku:ImageVersioncodiert ist.

Bilder mit benutzerdefiniertem Preisplan

Freigegebene Bildergaleriebilder, für die ein Preisplan hinterlegt ist, erfordern Informationen über den zu verwendenden Plan, es sei denn, diese Informationen sind im Bild der freigegebenen Bildergalerie gespeichert. Das wird mit dem ImagePlan Attribut mit den geschachtelten Attributen Publisher, Product und Plan angegeben.

Hinweis

Die Verwendung von benutzerdefinierten Bildern mit einem Preisplan erfordert CycleCloud 8.0.2 oder höher.

Bild-ID

Alternativ kann auch die Ressourcen-ID eines VM-Images im Abonnement der Anmeldeinformationen verwendet werden:

Merkmal	Typ	Definition
Bild-ID	Schnur	Ressourcen-ID des VM-Images

Bildattribute

Marketplace-Image und -Images, die von ImageIds definiert werden, benötigen einige zusätzliche Einstellungen, um die CycleCloud-Betriebssystemerweiterung ordnungsgemäß zu konfigurieren:

Merkmal	Typ	Definition
DownloadJetpack	Boolean	Wenn "false" lautet, lädt CycleCloud Jetpack nicht aus dem Speicherkonto herunter. Jetpack muss bereits installiert sein. Hinweis: Nur Linux-Knoten werden unterstützt. Die Standardeinstellung ist „true“. In 8.4.1 hinzugefügt.
Installiere Jetpack	Boolean	Wenn "false" lautet, installiert CycleCloud Jetpack nicht auf neuen VMs. Die Standardeinstellung ist „true“.
Warten auf Installation	Boolean	Wenn "false" lautet, wartet CycleCloud nicht, bis Jetpack Installationsdetails meldet, wenn der virtuelle Computer erstellt wird. Die Standardeinstellung ist „true“.
JetpackPlatform	Schnur	Jetpack-Installationsplattform zur Verwendung: centos-7, centos-6, ubuntu-14.04, ubuntu-16.04, windows. Veraltet in 7.7.0.

Warnung

Einstellung InstallJetpack oder AwaitInstallation wird nicht empfohlen. Darüber hinaus benötigt die Einstellung DownloadJetpack ein benutzerdefiniertes Image mit der korrekten Version der Jetpack-Installation und wird nur für Umgebungen empfohlen, die Probleme beim Herunterladen aus Speicherkonten haben.

Hinweis

ImageId wird standardmäßig verwendet, wenn mehrere Bilddefinitionen in einer einzelnen Knotendefinition enthalten sind.

Alternatives Bildbeispiel

Hier ist eine Beispielvorlage mit den drei alternativen Bildkonstrukten für die Knoten:

[cluster image-example]
  [[node defaults]]
    Credentials = $Credentials
    MachineType = Standard_D2_v3
    SubnetId = my-rg/my-vnet/my-subnet

  [[node cycle-image]]
    ImageName = cycle.image.ubuntu16

  [[node my-custom-vm-image]]
    ImageId = /subscriptions/9B16BFF1-879F-4DB3-A55E-8F8AC1E6D461/resourceGroups/my-rg/providers/Microsoft.Compute/images/jetpack-rhel7-1b1e3e93

    # Jetpack already installed on image
    DownloadJetpack = false

  [[node marketplace-vm-image]]
    Azure.Publisher = Canonical
    Azure.Offer = UbuntuServer
    Azure.Sku = 16.04-LTS
    Azure.ImageVersion = latest

  [[node custom-marketplace-vm-image]]
    ImageName = /subscriptions/9B16BFF1-879F-4DB3-A55E-8F8AC1E6D461/resourceGroups/my-rg/providers/Microsoft.Compute/images/jetpack-rhel8-1b1e3e93
    ImagePlan.Name = rhel-lvm8
    ImagePlan.Publisher = redhat
    ImagePlan.Product = rhel-byos

Erweiterte Netzwerkattribute

Merkmal	Typ	Definition
IsReturnProxy	Boolean	Richten Sie den Reversekanalproxy für diesen Knoten ein. Nur ein Knoten pro Cluster kann diese Einstellung als "true" aufweisen.
ReturnPath.Hostname	Rechnername	Hostname, auf dem der Knoten CycleCloud erreichen kann.
ReturnPath.WebserverPort	Integer	Webserver-Port, über den der Knoten CycleCloud erreichen kann.
ReturnPath.BrokerPort	Integer	Broker, über den der Knoten CycleCloud erreichen kann.

Stichwörter

CycleCloud unterstützt das Kategorisieren von VMs und VMSS.

Merkmal	Schnur	Definition
Stichwörter	Schnur	Verwenden Sie tags.my-tag = my-tag-value, um Tags zur Bereitstellung hinzuzufügen, zusätzlich zu den Tags, die CycleCloud standardmäßig zuweist.

Reguläre/Spotattribute

CycleCloud unterstützt die Verwendung von Spot-VMs über die folgenden Attribute. Weitere Details finden Sie unter Spot Virtual Machines .

Merkmal	Schnur	Definition
Unterbrechbar	Boolean	Wenn es wahr ist, wird die VM eine Spot-VM, um reduzierte Kosten zu ermöglichen.
Maximalpreis	Schweben	Der maximale Preis, der für die VM ausgegeben werden soll. (Standardwert: -1)

Nodearray-spezifische Attribute

Alle Attribute für einen Knoten sind für ein Knotenarray gültig, aber ein Knotenarray ist eine elastische Ressource, sodass zusätzliche Attribute verfügbar sind. Nodearray ist ein Treiber für Azure VirtualMachine ScaleSets (VMSS) und kann viele sichernde VMSS haben.

Merkmal	Schnur	Definition
Azure.AllocationMethod	Schnur	Legen Sie diese Einstellung auf StandAlone fest, um einzelne VMs zu verwalten, oder lassen Sie sie undefiniert, um VMSS zu verwenden.
Azure.SingleScaleset	Boolean	Verwenden Sie einen einzelnen VMSS für alle Knoten (Standard: false).
Azure.SinglePlacementGroup	Boolean	Verwenden Sie die Einstellung für einzelne Platzierungsgruppen für VMSS. (Standardwert: false)
Azure.Overprovision	Boolean	Verwenden Sie das Feature "Overprovision" von VMSS. Cyclecloud wird je nach Szenario dynamisch festgelegt. Dies ist eine Außerkraftsetzung.
Azure.MaxScaleSetSize	Integer	Beschränken Sie die Anzahl der virtuellen Computer in einem einzelnen VMSS. Sobald dieses Maximum erreicht ist, fügt CycleCloud zusätzliche VMSS zum Cluster hinzu. (Standardwert: '40')
InitialCount	Integer	Anzahl der Knoten, die beim Starten des Clusters gestartet werden sollen.
MaxCount	Integer	Um sicherzustellen, dass der Cluster niemals 10 Knoten überschreitet, geben Sie einen Wert von 10 an. Beachten Sie, dass MaxCount und MaxCoreCount zusammen verwendet werden können, in diesem Fall wird die niedrigere effektive Einschränkung wirksam.
InitialCoreCount	Integer	Anzahl der Kerne, die beim Starten des Clusters gestartet werden sollen.
Maximale Kernanzahl	Integer	Um sicherzustellen, dass der Cluster niemals 100 Kerne überschreitet, geben Sie einen Wert von 100 an. Beachten Sie, dass MaxCount und MaxCoreCount zusammen verwendet werden können, in diesem Fall wird die niedrigere effektive Einschränkung wirksam.
ShutdownPolicy	Schnur	Gibt an, was mit dem virtuellen Computer zu tun ist, wenn ein Knoten heruntergefahren wird. Wenn der virtuelle Computer beim Herunterfahren des Knotens "beendet" wird, wird der virtuelle Computer gelöscht. Wenn "deallocate", wird der Knoten stattdessen beendet. (Standard: beenden)
ThrottleCapacity	Boolean	Gibt an, ob Anforderungen an Azure beim Empfangen des Insufficient Capacity Signals angehalten werden sollen. (Standardwert: false)
ThrottleCapacityTime	Relative Zeit	Backoffzeit nach dem Insufficient Capacity Empfangen von Signal von Azure. AvailableCount wird während dieses Zeitraums als Null angezeigt. (Standard: „5m“)

Hinweis

Alle VMSS werden zugewiesen. FaultDomainCount = 1

Vererbung

Knoten und Knotenarrays, die eng miteinander verknüpft sind, können von anderen Knoten in derselben Clustervorlage abgeleitet werden. Diese geerbten Definitionen minimieren die Deklarationen, die für gemeinsame Attribute erforderlich sind. Häufig verwendet wird der [[node defaults]] Abschnitt, bei dem es sich um eine spezielle abstrakte Definition handelt, die für alle Knoten und Knotenarrays im Cluster gilt.

Merkmal	Schnur	Definition
Zusammenfassung	Boolean	Wenn wahr, sollten Sie keinen Knoten oder Knotenarray im Cluster erstellen. Der Abstract kann für die Vererbung verwendet werden. (Standardeinstellung: false)
Erweitert	Zeichenfolge (Liste)	Sortierte Liste der geerbten Knoten-/Knotenarraynamen. Elemente, die sich später in der Liste befinden, haben Vorrang, wenn Werte in Konflikt geraten. Der Knoten "Standardwerte" wird immer zuerst in der Liste angezeigt. (Standardwert: [])

Untergeordnete Objekte

Die Node-/Nodearray-Objekte weisen Volume, Netzwerkschnittstelle, Clusterinit, Eingabeendpunkt und Konfiguration als untergeordnete Objekte auf.