De SaltStack Config resource toevoegen aan de cloudsjabloon

Als ontwikkelaar van cloudsjablonen kunt u eigenschappen toevoegen aan de YAML om de Salt-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 Automation Assembler-eigenschappen voor een voorbeeld.

Als de Salt-minion in een Windows-omgeving is geïmplementeerd, vindt u aanvullende afhankelijkheidsvereisten in Spinning up Windows Minions.

Procedure

1. Selecteer Ontwerp > Cloudsjablonen in Automation Assembler.
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.

   Opmerking: De eigenschap createTimeout is standaard ingesteld op 30 minuten. U kunt deze instelling indien nodig bijwerken met de indeling min/uur, bijvoorbeeld: 30 m of 1 u.

   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 Automation 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 Automation 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 Automation Assembler.
   saltEnvironment	In dit voorbeeld is sse een bestandslocatie voor de statusbestanden. Mogelijk staan uw statusbestanden op andere bestandsserverlocaties in Automation 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
           skipUserCreation: true

   Opmerking: De eigenschap skipUserCreation is voor externe toegang. Een gebruiker wordt standaard gemaakt als deze eigenschap niet is gedefinieerd in de cloudsjabloon of als de waarde false is. Als u de waarde instelt op true, zoals in dit voorbeeld, wordt het maken van een nieuwe gebruiker overgeslagen.
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
           skipUserCreation: true
         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 Automation 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 Automation Config te openen, klikt u in de rechterbovenhoek op het menu Applicaties en klikt u op Cloud Services-console.
2. Open de VMware Aria Automation-service.
3. Klik op de servicetegel Config.
4. Vouw Minionsleutels uit in Automation Config en klik op Geaccepteerd.
5. 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.
   
   
6. 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 Automation Assembler 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 Automation Config of als u graingegevens snel wilt weergeven zonder de Automation Assembler-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 Automation Assembler 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: U kunt ook de Salt Grain-gegevens weergeven door op Resources > Virtuele machines te klikken en de gewenste VM te selecteren om machineconfiguraties en kenmerken weer te geven.