Het doel van dit gebruiksscenario is om de Salt-minionservice programmatisch op een minion te installeren door een Linux-VM te verbinden met uw Automation Config-omgeving.

Voorwaarden

Voordat u een minion kunt implementeren met behulp van de API in een Linux-omgeving, is het volgende nodig:
  • U moet een Automation Config-omgeving hebben waarin RaaS is geïmplementeerd.
  • Er moet een Salt-master en Salt-minion zijn geïnstalleerd.
  • Er moet een Linux-VM zijn geïmplementeerd.
  • Zorg ervoor dat poort 22 niet is afgeschermd met een firewall en beschikbaar is voor gebruik met minions.

Procedure

  1. Controleer of de map etc/salt/cloud.deploy.d een verzameling van deze bestanden bevat. Deze bestanden moeten overeenkomen met de OS-distributierelease en de Salt-release die uw systeem vereist.
    Een lijst met de vereiste bestanden in de directory cloud.deploy.d op een Salt-master

    Als u de bestanden niet ziet, neemt u contact op met de helpdesk.

    Opmerking: De xxxx in de bestandsnaam, bijvoorbeeld salt-xxxx-redhat-8-x86_64-amd64.tar.gz, moet overeenkomen met de versie van de Salt-master. Om de versie van de Salt-master te controleren, voert u het commando salt-master -V op de Salt-master uit.
  2. Als uw omgeving een luchtmuur heeft, voltooit u deze stappen:
    1. Open het RaaS-configuratiebestand in /etc/raas/raas.
    2. Voeg deze regels toe aan het configuratiebestand: 
      minion_deployment:
  airgap_install: true
    3. Herstart de RaaS-service met het commando service raas restart.
    Opmerking: Als u een geharde Linux VM gebruikt, zijn er bepaalde situaties waarin scripts niet kunnen worden uitgevoerd vanuit /tmp op de VM.
    • Als u Automation Assembler versie 8.10.2 of hoger gebruikt: voeg de eigenschap additionalAuthParams toe aan de Automation Config-resource in de cloudsjabloon. Zie De Automation Config-resource toevoegen aan de cloudsjabloon voor meer informatie. 
      additionalAuthParams:
  profile:
    tmp_dir: /var/cache/salt
    • Als u Automation Assembler versie 8.10.1 of lager gebruikt: wijzig het bestand /etc/salt/cloud.providers.d/ssc_saltify_provider.conf met 
      ssc_saltify_provider:
  driver: saltify
  tmp_dir: /var/cache/salt
      Als dit configuratiebestand niet bestaat, maakt u het en voegt u de bovenstaande instelling toe.
  3. Om de FQDN van de Salt-master te controleren, voert u het commando salt saltmaster grains.get fqdn op de terminal van de Salt-master uit.
  4. Zorg ervoor dat de FQDN is geconfigureerd voor de Salt-master door het commando ping [FQDN] uit te voeren.
    De resultaten van het uitvoeren van het commando ping FQDN op een Linux-machine
  5. Voer python3 uit om Python te openen.
  6. Maak deze API-aanroep met behulp van een SSEAPI-client met de juiste verificatiegegevens voor uw omgeving: 
    from sseapiclient import APIClient

client = APIClient('https://<master-ip>', '<ssc-username>', '<sscpassword>', ssl_validate_cert=False)


client.api.minions.deploy_minion(

 master_id = '<master-id>',

 host_name_ip = '<prospective minion’s ip>',

 os = ‘<prospective minion’s os>’,

 minion_id = '<desired-minion-name-for-prospective-minion>',

 username = '<ssh-username-for-prospective-minion>', 

 password = '<ssh-password-for-prospective-minion>',

)

    De uitvoering van de functie deploy.minion wordt gestart in uw Automation Config-omgeving. U kunt controleren of de opdracht wordt uitgevoerd op het tabblad Activiteit van de gebruikersinterface van Automation Config.

    Opmerking: Als u een minion vanuit Automation Assembler implementeert, wordt deze API-aanroep uitgevoerd door Automation Assembler.

resultaten

De minion is met succes geïmplementeerd en geconfigureerd vanuit uw Linux-omgeving en API-aanroep.

Volgende stappen

Controleer of de minion is geïmplementeerd door het commando test.ping op de minion uit te voeren met behulp van het venster Opdracht uitvoeren of door de commando's \* test.ping en \* test.versions uit te voeren in het commandovenster van de Salt-master.