Delen via


Knooppunt- en Nodearray-objecten

Knooppunt- en knooppuntarray-objecten zijn objecten van rang 2 die ondergeschikt zijn aan cluster. Een knooppunt vertegenwoordigt één virtuele machine, terwijl een knooppuntarray een set van virtuele machines of ten minste één virtuele-machineschaalset kan vertegenwoordigen.

Standaardinstellingen voor knooppunten

Dit [[node defaults]] is een speciaal abstract knooppunt dat de standaardinstellingen voor alle knooppunten en knooppuntmaarrays in een cluster aangeeft:

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

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

Dit $Credentials is een verwijzing naar een parameter met de naam Credentials.

In my-clustergrid knooppuntmaarray de referentie- en subnet-id-waarden over van het node defaults knooppunt, maar gebruikt een specifieke HPC-VM-grootte van .Standard_H16

Voorbeeld

Met deze voorbeeldsjabloon maakt u een cluster met twee knooppunten en een knooppuntmatrix. Het proxyknooppunt gebruikt de IsReturnProxy eigenschap om de speciale rol van ReturnProxy te definiëren. Dit knooppunt fungeert als het eindpunt voor een omgekeerde kanaalproxy die afkomstig is van CycleCloud wanneer het cluster wordt gestart.

[cluster my-cluster]

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

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

  [[node scheduler]]
    MachineType = Standard_D4s_v3

  [[nodearray execute]]
    MachineType = Standard_D16s_v3

Referentie voor vereist kenmerk

U hebt ten minste vier vereiste kenmerken nodig om een knooppunt te starten:

Kenmerk Typ Definitie
MachineType Touwtje De grootte van de Virtuele Azure-machine
SubnetId Touwtje Subnetdefinitie in de vorm ${rg}/${vnet}/${subnet}. Houd er rekening mee dat deze waarde niet de volledige resource-id is.
Inloggegevens Touwtje Naam van het cloudprovideraccount.

Het vierde vereiste kenmerk heeft betrekking op een afbeelding. U moet een afbeeldingskenmerk opgeven, maar u kunt kiezen uit verschillende formulieren. Zie Afbeeldingskenmerken voor meer informatie.

Aanvullende kenmerken

Kenmerk Typ Definitie
Computernaam Touwtje Computernaam voor de virtuele machine. Als u dit kenmerk opgeeft, wordt de door het systeem gegenereerde naam overschreven.
ComputerNaamVoorkeur Touwtje Voorvoegsel toegevoegd aan door het systeem gegenereerde computernamen.
Gebied string (lijst) Beschikbaarheidszone voor de VM of virtuele machineschaalsets. Dit kan een lijst zijn voor virtuele-machineschaalsets. Bijvoorbeeld: Zone = 1,3.
KeyPairLocation Geheel getal Locatie waar CycleCloud een SSH-keypair vindt in het lokale bestandssysteem.
KeepAlive Booleaan Indien waar, voorkomt CycleCloud de beëindiging van dit knooppunt.
Locker Touwtje De naam van het kluisje dat moet worden gebruikt voor het downloaden van projectspecificaties. Zie Projecten gebruiken.
Kenmerk Typ Definitie
Computernaam Touwtje Computernaam voor de virtuele machine. Als u een naam opgeeft, overschrijft deze de door het systeem aangemaakte naam.
ComputerNaamVoorkeur Touwtje Voorvoegsel toegevoegd aan door het systeem gegenereerde computernamen.
TijdelijkeOSDisk Booleaan Gebruik een tijdelijke opstartschijf voor de VIRTUELE machine, indien ondersteund.
Gebied string (lijst) Beschikbaarheidszone voor de VM of virtuele-machineschaalset. Dit kan een lijst zijn voor Virtual Machine Scale Sets. Bijvoorbeeld: Zone = 1,3.
ProximityPlacementGroepId Touwtje Volledige id voor de nabijheidsplaatsingsgroep waarin dit knooppunt moet worden geplaatst. Moet beginnen met /subscriptions/.
PlaatsingGroepId Touwtje Als dit label is ingesteld, wordt het knooppunt in één plaatsingsgroep geplaatst met alle andere knooppunten met een overeenkomende waarde voor PlacementGroupId. Deze configuratie biedt communicatie met een lagere latentie en is vereist om InfiniBand in te schakelen op VM-grootten die deze ondersteunen. De scheduler stelt deze waarde meestal zo nodig in, dus u hoeft deze niet handmatig op te geven.
KeyPairLocation Geheel getal Waar CycleCloud een SSH-keypair vindt in het lokale bestandssysteem
KeepAlive Booleaan Indien waar, voorkomt CycleCloud de beëindiging van dit knooppunt
Locker Touwtje Naam van de kluis waaruit projectspecificaties moeten worden gedownload. Zie Gebruik projecten
BootDiagnosticsUri Touwtje Opslag-URI voor diagnostische gegevens over opstarten (bijvoorbeeld: https://mystorageaccount.blob.core.windows.net/), indien opgegeven. Opslagkosten zijn van toepassing.
HybridBenefit Booleaan Indien waar, schakelt u licenties voor Azure Hybrid Benefit in voor Windows-VM's
NetwerkBeveiligingsGroepId Touwtje Indien opgegeven, de volledige resource-ID voor een netwerkbeveiligingsgroep die voor dit knooppunt kan worden gebruikt. U kunt deze waarde ook opgeven als SecurityGroup op een netwerkinterface.
EnableTerminateNotification (8.2.0+) Booleaan Als dit waar is, schakelt u de Beëindigingsmelding in om gebeurtenissen over het verwijderen van de VM naar de VM te verzenden voor lokale verwerking. Deze instelling is alleen van toepassing op VM's van Schaalsets.
TerminateNotificationTimeout (8.2.2+) Relatieve tijd Als de beëindigingsmelding is ingeschakeld, bepaalt deze instelling hoe lang VM's de gebeurtenis moeten afhandelen voordat ze worden verwijderd.
ThrottleCapacity (8.2.2+) Booleaan Als het waar is, rapporteert de knooppuntenarray 0 capaciteit voor automatisch schalen gedurende een standaardperiode van vijf minuten na een capaciteitsprobleem.
ThrottleCapacityTime (8.2.2+) Relatieve tijd Als u ThrottleCapacity inschakelt, stelt u in hoe lang u 0 beschikbaarheid moet rapporteren nadat de capaciteit is beperkt. De standaardwaarde is 5 min.
HybridBenefitLicense (8.3.0+) Touwtje Als HybridBenefit waar is, geeft u de licentie op die u wilt gebruiken: RHEL_BYOS, SLES_BYOSof Windows_Server. De standaardwaarde is Windows_Server.
FlexScaleSetId (8.3.0+) Touwtje Voer de volledig gekwalificeerde id in van een schaalset in de Flex-orkestratiemodus die u wilt gebruiken voor de VM in dit knooppunt.
EncryptionAtHost (8.4.0+) Booleaan Indien waar, is versleuteling op host ingeschakeld voor de virtuele machine.
Beveiligingstype (8.5.0+) Touwtje Hiermee stelt u het beveiligingstype in; niet gedefinieerd, TrustedLaunchof ConfidentialVM.
EnableSecureBoot (8.5.0+) Booleaan Hiermee schakelt u Beveiligd opstarten in als u vertrouwde start-VM's of vertrouwelijke VM's gebruikt.
EnableVTPM (8.5.0+) Booleaan Hiermee schakelt u virtual Trusted Platform Module in als u vertrouwde start-VM's of vertrouwelijke VM's gebruikt.
ScaleSetUpgradePolicyMode (8.6.2+) Touwtje Hiermee geeft u het upgradebeleid voor de schaalinstelling op. Met dit beleid bepaalt u wat er gebeurt met bestaande VM's in een schaalset wanneer u de schaalsetsjabloon wijzigt buiten CycleCloud. Schakel dit beleid over het algemeen in als u een geautomatiseerd hulpprogramma gebruikt om bestaande schaalsets, zoals Azure Policy, te wijzigen. Opmerking: Dit beleid upgrade de installatiekopie van het besturingssysteem niet automatisch. Kies een van Automatic, Rollingof Manual (de standaardinstelling).

Opmerking

Een nabijheidsplaatsingsgroep is een algemene Azure-functie. U moet er een maken voordat u ernaar kunt verwijzen op een knooppunt. Met deze functie kunnen CycleCloud-VM's samen worden geplaatst met andere Azure-resources in die proximity placement group, maar InfiniBand-netwerken wordt niet ingeschakeld. In tegenstelling daarmee is PlacementGroupId een willekeurige tekenreeks in CycleCloud, gebruikt om VM's bij knooppunten te groeperen in een enkele schaalset. Deze schaalset is beperkt tot onder dezelfde netwerkswitch, maar mogelijk komt deze niet overeen met andere Azure-resources. U kunt beide functies samen gebruiken, maar deze combinatie kan het aantal VM's verminderen dat u kunt toewijzen.

Afbeeldingskenmerken

U moet de VM-afbeelding specificeren om een virtuele machine te starten. Er zijn drie geldige vormen van afbeeldingsdefinities: standaard CycleCloud-afbeeldingsnamen, Marketplace-afbeeldingsdefinities en afbeeldings-id's.

Afbeeldingsnaam

CycleCloud ondersteunt verschillende standaard Marketplace-installatiekopieën voor verschillende versies van het besturingssysteem. U kunt deze afbeeldingen opgeven met een ImageName.

Kenmerk Typ Definitie
Afbeeldingsnaam Touwtje Cyclusgebaseerde afbeeldingsnaam.

Marketplace-afbeeldingen

Samen met cyclus beheerde marketplace-afbeeldingen kunt u elke marketplace-afbeelding gebruiken door de Publisher, Offer, Sku, en ImageVersion.

Kenmerk Typ Definitie
Azure.Publisher Touwtje Uitgever van VM Marketplace-afbeelding
Azure.Aanbod Touwtje Aanbieding voor VM Marketplace-afbeeldingen
Azure.Sku Touwtje SKU van VM Marketplace-afbeeldingen
Azure.ImageVersion Touwtje Afbeeldingsversie van marketplace-afbeelding

Opmerking

U kunt ook een Marketplace-afbeelding opgeven in het ImageName kenmerk. Codeer het als een URN in de vorm Publisher:Offer:Sku:ImageVersion.

Afbeeldingen met aangepast prijsplan

Afbeeldingen in de Shared Image Gallery waaraan een prijsplan is gekoppeld, vereisen informatie over het te gebruiken plan, tenzij die informatie is opgeslagen in de afbeelding in de Shared Image Gallery. Specificeer deze informatie met het ImagePlan kenmerk door de geneste attributen Publisher, Product en Plan te gebruiken.

Opmerking

Voor het gebruik van aangepaste afbeeldingen met een prijsplan is CycleCloud 8.0.2 of hoger vereist.

ImageId

U kunt ook de resource-ID van een VM-afbeelding gebruiken in de referentiesubscriptie.

Kenmerk Typ Definitie
ImageId Touwtje Resource-ID van VM-image

Afbeeldingskenmerken

Marketplace-afbeeldingen en afbeeldingen die u met ImageIds definieert, hebben enkele extra instellingen nodig om te werken met de CycleCloud OS-extensie.

Kenmerk Typ Definitie
DownloadJetpack Booleaan Als dit onwaar is, downloadt CycleCloud Jetpack niet vanuit het opslagaccount. Jetpack moet al zijn geïnstalleerd. Opmerking: alleen Linux-knooppunten worden ondersteund. De standaardwaarde is true. Toegevoegd in 8.4.1.
InstallJetpack Booleaan Als dit onwaar is, installeert CycleCloud Jetpack niet op nieuwe VM's. De standaardwaarde is true.
In Afwachting Van Installatie Booleaan Als onwaar, wacht CycleCloud niet totdat Jetpack installatiegegevens rapporteert bij het aanmaken van de virtuele machine. De standaardwaarde is true.
JetpackPlatform Touwtje Te gebruiken Jetpack-installatieplatform: centos-7, centos-6, ubuntu-14.04, ubuntu-16.04, windows. Afgekeurd in 7.7.0.

Waarschuwing

We raden aan om de instellingen InstallJetpack of AwaitInstallation niet te gebruiken. Bovendien vereist het instellen van DownloadJetpack een aangepaste afbeelding met de correcte versie van Jetpack. DownloadJetpack alleen instellen als uw omgeving problemen ondervindt bij het downloaden vanuit opslagaccounts.

Opmerking

Als u meerdere beelddefinities in één knooppuntdefinitie opneemt, gebruikt de implementatie standaard ImageId.

Voorbeeld van alternatieve afbeelding

In de volgende voorbeeldsjabloon worden de drie alternatieve beeldconstructies die voor de knooppunten worden gebruikt:

[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

Geavanceerde netwerkkenmerken

Kenmerk Typ Definitie
IsReturnProxy Booleaan Stel een omgekeerde kanaalproxy in op dit knooppunt. Slechts één knooppunt per cluster kan deze instelling als waar hebben.
ReturnPath.Hostname Hostnaam Hostnaam waar het knooppunt CycleCloud kan bereiken.
ReturnPath.WebserverPort Geheel getal Webserverpoort waar het knooppunt CycleCloud kan bereiken.
ReturnPath.BrokerPort Geheel getal Broker waarmee het knooppunt CycleCloud kan bereiken.

Tags

CycleCloud biedt ondersteuning voor het taggen van VM's en virtuele-machineschaalsets.

Kenmerk Touwtje Definitie
Tags Touwtje Gebruik tags.my-tag = my-tag-value om tags toe te voegen aan de implementatie, naast de tags die standaard door CycleCloud zijn toegewezen.

Reguliere/spot-kenmerken

CycleCloud ondersteunt het gebruik van spot-VM's via de volgende kenmerken. Zie Spot Virtual Machines voor meer informatie.

Kenmerk Touwtje Definitie
Onderbreekbaar Booleaan Als dat zo is, is de virtuele machine een spot-VM die gereduceerde prijzen biedt.
MaxPrijs zweven De maximumprijs die u wilt betalen voor de virtuele machine. (Standaard: -1)

Nodearray-specifieke kenmerken

Alle kenmerken voor een knooppunt zijn geldig voor een knooppuntmatrix, maar een knooppuntmatrix is een elastische resource, zodat er extra kenmerken beschikbaar zijn. Nodearray is een driver voor Azure VirtualMachine-ScaleSets en kan meerdere ondersteunde virtuele-machineschaalsets hebben.

Kenmerk Touwtje Definitie
Azure.Allocatiemethode Touwtje Stel dit kenmerk in op StandAlone om één virtuele machine te beheren of laat het niet gedefinieerd om Virtual Machine Scale Sets te gebruiken.
Azure.SingleScaleset Booleaan Gebruik één virtuele-machineschaalset voor alle knooppunten (standaard: false).
Azure.SinglePlacementGroup Booleaan Gebruik de instelling voor een enkele plaatsingsgroep voor de Virtuele Machine-Schaalset. (Standaard: onwaar)
Azure.Overprovisioneren Booleaan Gebruik de Overprovision-functie van Virtuele Machine-schaalsets. Cyclecloud stelt deze waarde dynamisch in, afhankelijk van het scenario. Deze waarde is een overschrijving.
Azure.MaxScaleSetSize Geheel getal Beperk het aantal virtuele machines in één virtuele-machineschaalset. Zodra dit maximum is bereikt, voegt CycleCloud extra Virtuele-machineschaalsets toe aan het cluster. (Standaard: "40")
Beginwaarde Geheel getal Het aantal knooppunten dat moet worden gestart bij het opstarten van het cluster.
Maximale Aantal Geheel getal Geef een waarde van 10 op om ervoor te zorgen dat het cluster nooit meer dan 10 knooppunten overschrijdt. Gebruik MaxCount en MaxCoreCount samen. De lagere effectieve beperking wordt van kracht.
InitialeKernaantal Geheel getal Het aantal kernen dat moet worden gestart wanneer het cluster wordt gestart.
Maximale Core-aantal Geheel getal Geef een waarde van 100 kernen op om ervoor te zorgen dat het cluster nooit meer dan 100 kernen overschrijdt. Gebruik MaxCount en MaxCoreCount samen. De lagere effectieve beperking wordt van kracht.
Afsluitingsbeleid Touwtje Geeft aan wat er met de VM moet gebeuren wanneer een knooppunt uitvalt. Als terminate het geval is, wordt de virtuele machine verwijderd wanneer het knooppunt wordt afgesloten. Als deallocate, wordt de knooppunt juist gestopt. (Standaard: beëindigen)
Kenmerk Touwtje Definitie
Azure.Allocatiemethode Touwtje Stel deze waarde in op StandAlone om één virtuele machine te beheren of laat deze ongedefinieerd om virtuele-machine-schaalsets te gebruiken.
Azure.SingleScaleset Booleaan Gebruik een enkele virtuele-machineschaalset voor alle knooppunten (standaard: false).
Azure.SinglePlacementGroup Booleaan Gebruik de instelling voor één Plaatsingsgroep voor de Virtual Machine Scale Set. (Standaard: onwaar)
Azure.Overprovisioneren Booleaan Gebruik de functie Overprovision van virtuele machine-schaalsets. CycleCloud stelt deze waarde dynamisch in, afhankelijk van het scenario. Deze instelling fungeert als een overschrijving.
Azure.MaxScaleSetSize Geheel getal Beperk het aantal virtuele machines in een enkele virtuele-machineschaalset. Zodra dit maximum is bereikt, voegt CycleCloud extra Virtuele-machineschaalsets toe aan het cluster. (Standaard: "40")
Beginwaarde Geheel getal Het aantal knooppunten dat moet worden gestart bij het opstarten van het cluster.
Maximale Aantal Geheel getal Geef een waarde van 10 op om ervoor te zorgen dat het cluster nooit meer dan 10 knooppunten overschrijdt. Gebruik MaxCount en MaxCoreCount samen. De lagere effectieve beperking wordt van kracht.
InitialeKernaantal Geheel getal Het aantal kernen dat moet worden gestart wanneer het cluster wordt gestart.
Maximale Core-aantal Geheel getal Geef een waarde van 100 kernen op om ervoor te zorgen dat het cluster nooit meer dan 100 kernen overschrijdt. Gebruik MaxCount en MaxCoreCount samen. De lagere effectieve beperking wordt van kracht.
Afsluitingsbeleid Touwtje Geeft aan wat er met de VM moet gebeuren wanneer een knooppunt uitvalt. Als u de waarde instelt op terminate, wordt de virtuele machine verwijderd wanneer het knooppunt wordt afgesloten. Als u de waarde op deallocate instelt, wordt het knooppunt in plaats daarvan gestopt. (Standaard: beëindigen)
Beperkingscapaciteit Booleaan Of aanvragen naar Azure moeten worden onderbroken bij het ontvangen van Insufficient Capacity signaal. (Standaard: onwaar)
SmoorklepCapaciteitTijd Relatieve tijd Uitsteltijd na ontvangst van Insufficient Capacity signaal van Azure. AvailableCount wordt in deze periode als nul gerapporteerd. (Standaard: 5m)

Opmerking

Alle virtuele machineschaalsets worden toegewezen FaultDomainCount = 1.

Erfenis

U kunt knooppunten en knooppuntmatrices afleiden die nauw verwant zijn aan andere knooppunten in dezelfde clustersjabloon. Deze overgenomen definities verminderen het aantal declaraties dat u nodig hebt door algemene kenmerken te delen. De veelgebruikte [[node defaults]] sectie is een speciale abstracte definitie die van toepassing is op alle knooppunten en knooppuntmatrices in het cluster.

Kenmerk Touwtje Definitie
Samenvatting Booleaan Als dit waar is, maakt u geen knooppunt- of knooppuntmatrix in het cluster. Gebruik de abstract voor overname. (Standaard: onwaar)
Verlengt string (lijst) Geordende lijst met overgenomen knooppunt- en knooppuntmatrixnamen. Items verderop in de lijst hebben voorrang wanneer waarden conflicteren. Het defaults knooppunt wordt altijd effectief eerst in de lijst weergegeven. (Standaard: [])

Onderliggende objecten

De knooppunt- en knooppuntarray-objecten hebben volume, netwerkinterface, cluster-init, invoereindpunt en configuratie als onderliggende objecten.