De SaltStack Config-resource toevoegen aan de cloudsjabloon

Als ontwikkelaar van cloudsjablonen kunt u eigenschappen toevoegen aan de YAML om de SaltStack Config-minion te installeren wanneer u de sjabloon implementeert.

De kerneigenschappen die u toevoegt aan de sjabloon, omvatten externe toegang voor de machine die u wilt implementeren, en configuratie-eigenschappen voor de SaltStack Config-resource. Het gaat in deze procedure alleen over geselecteerde eigenschappen. De YAML biedt ook andere SaltStack Config-resource-eigenschappen die niet in dit voorbeeld worden gebruikt. Bekijk het schema voor meer informatie.

In dit voorbeeld ziet u hoe u een gebruikersnaam en wachtwoord toevoegt voor de eigenschappen voor externe toegang, maar u kunt ook een geheime eigenschap configureren en deze toevoegen aan de sjabloon. Zie Geheime Cloud Assembly-eigenschappen voor een voorbeeld.

Procedure

1. Selecteer Ontwerp > Cloudsjablonen in Cloud Assembly.
2. Open een bestaande sjabloon.
3. Zoek de SaltStack Config-resource en sleep deze naar het canvas.
4. Koppel de SaltStack Config-resource aan de machine waarop de minion wordt geïnstalleerd.
5. Voeg eigenschappen toe aan de SaltStack Config-resource in het codevenster.

   Het is niet vereist om alle mogelijke eigenschappen toe te voegen. De gebruikte waarden in dit voorbeeld worden uitgelegd in de tabel.

   Cloud_SaltStack_1:
       type: Cloud.SaltStack
       properties:
         masterId: saltstack_enterprise_installer
         hosts:
           - ${resource["Cloud_VM_1".id}
         saltEnvironment: sse
         stateFiles:
           - /doe.sls
         variables: 
           user: joe
         additionalMinionParams:
           grains:
             roles:
               - webserver
               - database   
          additionalAuthParams:
            profile:
               tmp_dir: /var/run

   Hier vindt u een beschrijving van de Cloud_SaltStack_1-eigenschappen die in dit voorbeeld worden gebruikt.

   Eigenschap	Beschrijving
   masterId	In het voorbeeldschema is saltstack_enterprise_installer de waarde voor masterId. Mogelijk heeft u al master-id's in SaltStack Config gedefinieerd via Beheer > Mastersleutels .
   hosts	De waarde voor hosts is de id van de machine of het cluster met machines waarop u de minion wilt installeren. Standaard wordt de naam van de machine doorgegeven als minion-id in SaltStack Config. Het wordt aanbevolen dat u machinenamen van 15 tekens of minder kiest, in het bijzonder als u minions in Windows implementeert. Windows staat geen hostnamen van meer dan 15 tekens toe. Als u een aangepaste naamgevingsconventie wilt definiëren voor de machines die u wilt implementeren, raadpleegt u Aangepaste naamgeving voor geïmplementeerde resources in Cloud Assembly.
   saltEnvironment	In dit voorbeeld is sse een bestandslocatie voor de statusbestanden. Mogelijk staan uw statusbestanden op andere bestandsserverlocaties in SaltStack Config in Configuratie > Bestandsserver .
   stateFiles	In dit voorbeeld is doe.sls een statusbestand in de bestandsserverdirectory die is opgegeven als saltEnvironment.
   variables	Variabelen die in de cloudsjabloon zijn gedefinieerd, worden als pillars doorgegeven aan Salt-statussen. In dit voorbeeld wordt de variabele user doorgegeven aan het bestand doe.sls. Er kan naar variabelen worden verwezen in statusbestanden met Jinja, zoals u in het volgende voorbeeld ziet: {% set username = pillar.get('user', 'random') %} friend: user.present: - names: - {{username}} Het bestand doe.sls zorgt ervoor dat een gebruiker, voorgesteld door de variabele user in de cloudsjabloon, bestaat. Als de variabele niet is opgegeven in de cloudsjabloon, verzekert dit de gebruiker ervan dat random aanwezig is.
   additionalMinionParams	Gebruik deze eigenschap om aanvullende configuratieparameters door te geven voor de minion. Deze parameters moeten worden doorgegeven als woordenboek: grains: gebruik deze eigenschap om aangepaste Salt-grains toe te wijzen aan de minion. Een of meer paren key:value worden geaccepteerd. De waarden kunnen een tekenreeks, een array of een toewijzing zijn. U kunt alleen aangepaste graingegevens toewijzen bij het inrichten van een nieuwe machine. U kunt geen aangepaste graingegevens toewijzen tijdens het uitvoeren van de acties voor dag 2 SaltStack-resource toewijzen of Salt-configuratie bijwerken.
   additionalAuthParams	Gebruik deze eigenschap om aanvullende autorisatieparameters door te geven voor de inrichting van de minion die wordt samengevoegd/overschreven met de standaard Salt-cloudconfiguratie. Deze parameters moeten worden doorgegeven als woordenboek. Een of meer sleutelwaardeparen worden geaccepteerd als tekenreeks, array of toewijzing. Zie Gebruiksscenario: Hoe implementeer ik minions met behulp van de API in een Linux-omgeving voor een voorbeeld van hoe deze eigenschap wordt gebruikt. Opmerking: U kunt geen aanvullende autorisatieparameters toewijzen tijdens het uitvoeren van de actie voor dag 2, Salt-configuratie bijwerken.

6. Voeg remoteAccess-eigenschappen toe aan de machine die als host fungeert voor de Salt-minion.

   Als u een Salt-minion implementeert op een Linux-machine, kan de sleutel authentication de waarde usernamePassword of generatedPublicPrivateKey hebben. publicPrivateKey wordt niet ondersteund.

   Als u een Salt-minion implementeert op een Windows-machine, moet usernamePassword. de waarde voor de sleutel authentication zijn.

    remoteAccess:
           authentication: usernamePassword
           username: adminUser
           password: adminPassword

7. Controleer of uw YAML vergelijkbare eigenschappen bevat als in het onderstaande voorbeeld.

   resources:
     Cloud-Network:
       type: Cloud.Network
       properties:
         networkType: existing 
     Cloud_VM_1:
       type: Cloud.vSphere.Machine
       properties:
         image: ubuntu
         flavor: small
         remoteAccess:
           authentication: usernamePassword
           username: adminUser
           password: adminPassword
         networks:
           - network: ${resource["Cloud-Network"].id}
     Cloud_SaltStack_1:
       type: Cloud.SaltStack
       properties:
         masterId: saltstack_enterprise_installer
         hosts:
           - ${resource["Cloud-VM-1"].id}
         saltEnvironment: sse
         stateFiles:
           - /doe.sls
         variables: 
           user: joe
         additionalMinionParams:
           grains:
             roles:
               - webserver
               - database

8. Test en implementeer de cloudsjabloon.
   Zie Problemen met minionimplementaties oplossen als uw minionimplementatie mislukt.
9. Controleer de Salt-configuratie-eigenschappen voor de geïmplementeerde machine.
   1. Selecteer Implementaties > Implementaties en open de implementatiedetails.
   2. Klik op het tabblad Topologie op de machine en vouw de eigenschappen voor de Salt-configuratie in het rechterdeelvenster uit.
      
      
      

De minion controleren in SaltStack Config

Nadat u de minion op de virtual machine hebt geïnstalleerd, zoekt u de minion en voert u taken of opdrachten uit voor de resource.

Procedure

1. Om SaltStack Config te openen, klikt u in de rechterbovenhoek op het menu Applicaties en klikt u op Cloud Services-console.
2. Klik op de servicetegel SaltStack Config.
3. Vouw Minionsleutels uit in SaltStack Config en klik op Geaccepteerd.
4. Klik in de kolom Minion-id op het filterpictogram en voer de naam van de minion in.
   De naam van de minion wordt standaard ingesteld op de hostnaam van de virtuele machine. In dit voorbeeld is vra-vm-010 de minion-id.
   
   
5. Als u de details wilt weergeven, klikt u op de naam van de minion.
   U kunt taken of opdrachten uitvoeren voor de minion. Bijvoorbeeld: inzage in schijfgebruik. Deze taak retourneert statistieken over het schijfgebruik voor een minion.
   
   

Salt-graingegevens weergeven

Nadat u een Salt-minion op uw virtuele machines heeft geïmplementeerd, kunt u de grains van de minion in Cloud Assembly bekijken.

Er worden Salt-grains verzameld voor het besturingssysteem, de domeinnaam, het IP-adres, de kernel, het type besturingssysteem, het geheugen en vele andere systeemeigenschappen van de minion. Als u geen toegang heeft tot SaltStack Config of als u graingegevens snel wilt weergeven zonder de Cloud Assembly-gebruikersinterface te verlaten, kunt u het tabblad Topologie gebruiken om graingegevens weer te geven. Zie Salt-grains voor meer informatie over graingegevens.

De grains van een minion weergeven:

1. Selecteer Resources > Implementaties in Cloud Assembly en zoek vervolgens naar uw implementatie.
2. Selecteer op het tabblad Topologie de virtuele machine die aan de SaltStack Config-resource is gekoppeld.
3. Zoek de sectie Salt-configuratie in het rechterdeelvenster en scrol omlaag om de lijst met graingegevens weer te geven.

De graingegevens van een minion worden opgehaald nadat u de minion heeft geïmplementeerd. Als u wilt zien wanneer de graingegevens voor het laatst zijn bijgewerkt, kunt u naar de onderkant van de sectie Salt-configuratie scrollen.

Opmerking: De graingegevens worden alleen bijgewerkt als u de actie voor dag 2 Salt-configuratie bijwerken uitvoert op een SaltStack Config-resource. De update wordt niet bijgewerkt als er wijzigingen zijn aangebracht buiten Cloud Assembly.