Opdrachten worden gebruikt om externe uitvoeringstaken uit te voeren, om staten toe te passen en om Salt-runners te starten. In de werkplek Opdrachten (Jobs) kunt u opdrachtinstellingen maken, configureren en opslaan voor hergebruik. Opdrachten zijn doorgaans bedoeld voor systeembewerkingen die moeten worden geautomatiseerd en meerdere keren moeten worden uitgevoerd, en configuratietijd besparen.

U kunt bijvoorbeeld een opdracht hebben die een virtuele machine maakt en implementeert en een basisset applicaties installeert. U kunt deze opdracht elke keer uitvoeren wanneer een nieuwe virtuele machine moet worden geïmplementeerd om ervoor te zorgen dat op elke implementatie dezelfde set applicaties en configuraties wordt toegepast.

Zie Werkstroom voor SaltStack Config-opdrachten voor een overzicht van het gebruik van de werkplek Opdrachten (Jobs), samen met de andere werkplekken in SaltStack Config om opdrachten te maken en te gebruiken voor configuratiebeheer.

U kunt opdrachten uitvoeren vanuit de werkplek Opdrachten (Jobs), de werkplek Minions of vanuit andere schermen in de gebruikersinterface van SaltStack Config, afhankelijk van de aard van de opdracht. U kunt ook opdrachten uitvoeren volgens een reguliere planning of u kunt ze alleen uitvoeren wanneer nodig. Doorgaans worden opdrachten die alleen worden uitgevoerd wanneer ze nodig zijn, aangeduid als ad-hocopdrachten.

Voor informatie over het uitvoeren van opdrachten zie:

  • Een opdracht uitvoeren voor informatie over het uitvoeren van opdrachten in de werkplek Opdrachten (Jobs)
  • Minions voor informatie over het uitvoeren van opdrachten in de werkplek Minions
  • Planningen (Schedules) voor informatie over het uitvoeren van opdrachten volgens een planning
Opmerking: Als onderdeel van het VMware-initiatief om problematische terminologie te verwijderen, zal de term Salt-master worden vervangen door een betere term in SaltStack Config en gerelateerde producten en documentatie. Het bijwerken van de terminologie kan enkele releasecycli in beslag nemen voordat dit volledig is voltooid.

Opdrachtvereisten

Elke opdracht in de werkplek Opdrachten (Jobs) heeft vooraf gedefinieerde instellingen. U kunt instellingen voor bestaande opdrachten bewerken of een nieuwe opdracht met eigen unieke instellingen maken.

Om een opdracht te kunnen uitvoeren, moet deze het volgende bevatten:

  • Een functie (de taak die door de opdracht moet worden voltooid)
  • Een doel, een Salt-master of meerdere Salt-masters
  • Op rollen gebaseerde rechten

U kunt een doel definiëren in de instellingen van een opdracht of het doel ongedefinieerd laten om een doel te selecteren telkens wanneer de opdracht wordt uitgevoerd. Door het doel van een opdracht te definiëren, wordt ook voorkomen dat die opdracht wordt uitgevoerd op knooppunten waarop deze niet moet worden uitgevoerd. Zie Minions voor meer informatie.

Met de werkplek Opdrachten (Jobs) kunt u op rollen gebaseerde toegang tot elke opdracht definiëren. Naast het definiëren van de toegang voor rollen tot de opdracht moet u ook rollenrechten toewijzen om de bijbehorende taken uit te voeren in de editor Rollen (Roles). Zie Rollen en rechten voor meer informatie.

In de werkplek Opdrachten (Jobs) kunt u nieuwe opdrachten maken en bestaande opdrachten bewerken. Zodra opdrachtinstellingen zijn gedefinieerd, kunt u ad-hocopdrachten uitvoeren of planningen maken om opdrachten in de toekomst uit te voeren. Zie Planningen voor meer informatie.

SaltStack Config bevat een besturingselement Opdracht uitvoeren (Run Command) waarmee u één opdracht kunt uitvoeren zonder een herbruikbare opdracht te definiëren. Dit is handig voor het snel uitvoeren van commando's of voor het uitvoeren van eenmalige opdrachten die geen onderdeel zijn van uw dagelijkse werkstroom, bijvoorbeeld bij probleemoplossing of tijdens de eerste configuratie. Zie Een commando uitvoeren voor meer informatie.

U kunt ook bepalen welke rollen verschillende opdrachten kunnen bekijken, bewerken, uitvoeren en verwijderen.

Toegang tot de werkplek Opdrachten (Jobs)

Als u de werkplek Opdrachten (Jobs) wilt gebruiken, klikt u op Configuratie > Opdrachten (Config > Jobs) in het zijmenu.

Een opdracht maken

Een nieuwe opdracht maken:

  1. Klik in de werkplek Opdrachten (Jobs) op Opdracht maken (Create job).
  2. Voer details in voor de nieuwe opdracht. De gegevens die u moet invoeren, zijn afhankelijk van het type opdracht dat u wilt maken. Zie Opdrachtinstellingen voor meer informatie.
  3. Klik op Opslaan. De opdracht kan nu worden uitgevoerd.

Een opdracht uitvoeren

Een ad-hocopdracht uitvoeren:

  1. Klik in de werkplek Opdrachten (Jobs) op het menu menupictogram-licht naast de opdracht die u wilt uitvoeren.
  2. Klik op Nu uitvoeren (Run Now).
  3. Selecteer in het pop-upvenster een doel waarop u de opdracht wilt uitvoeren.
    Opmerking: Als de opdracht is geconfigureerd om een doel- of Salt-master te bevatten, wordt deze opdracht weergegeven voor bevestiging.
  4. Selecteer desgewenst aanvullende opties.
    • Voorkeuren voor meldingen instellen
    • Selecteer Uitvoeren als test (Run as Test) om de opdracht waar nodig uit te voeren als test.
  5. Klik op Nu uitvoeren (Run Now).
    Opmerking: U kunt ook opdrachten uitvoeren vanuit de werkplek Minions. Zie Minions.

Zoeken naar een opdracht

Als u een lijst wilt weergeven met de beschikbare opdrachten die tot nu toe zijn gemaakt, gaat u naar de werkplek Opdrachten (Jobs).

Standaard worden er slechts 20 opdrachten tegelijk op een pagina weergegeven. Als u meer opdrachten wilt weergeven, klikt u op het menu Items per pagina (Items per page) onderaan de tabel met opdrachten en selecteert u het gewenste aantal opdrachten dat u wilt weergeven.

Een specifieke opdracht vinden:

  1. Klik in de werkplek Opdrachten (Jobs) op de filterknop filterpictogram voor de kolom waarin u wilt zoeken.
  2. Begin met het typen van de zoekcriteria om de rijen onmiddellijk te bekijken. U kunt bijvoorbeeld zoeken naar een opdracht op de Salt-module die is betrokken bij een opdracht, door de kolom Functie te filteren.
    Opmerking: U kunt ook één keer op een kolomnaam klikken om de rijen in aflopende volgorde te sorteren. Klik opnieuw om de volgorde om te keren. Zie Tabelkolommen filteren en sorteren voor meer informatie over filters.

Tabelkolommen filteren en sorteren

U kunt elke kolom filteren door het betreffende filterpictogram filterpictogram te selecteren en uw filtercriteria te selecteren of te typen. Klik op de knop Filters wissen (Clear Filters) boven de tabel met opdrachten om een filter te wissen.

U kunt ook een kolom sorteren door de naam van de kolom te selecteren. Als u wilt aanpassen welke kolommen in de tabel worden weergegeven, klikt u op de knop Kolommen weergeven (Show columns) pictogram-kolommen-weergeven in de linkerbenedenhoek van de tabel.

Opmerking: Filters, kolomsortering en instellingen voor kolomzichtbaarheid zijn persistent voor een bepaalde gebruiker, ongeacht het apparaat waarmee wordt aangemeld. Dit betekent dat wanneer een bepaalde gebruiker zich aanmeldt, hij of zij dezelfde filter-, sorteer- en zichtbaarheidsinstellingen ziet wanneer hij of zij zich de volgende keer aanmeldt totdat de filters zijn gewist of de sorteer- of zichtbaarheidsinstellingen zijn gewijzigd.

Opdrachtresultaten weergeven

De opdrachtresultaten weergeven:

  1. Klik in het zijmenu op Activiteit (Activity) en selecteer Voltooid (Completed) om een lijst met voltooide opdrachten weer te geven.
  2. Selecteer een opdracht-id in de kolom JID om de details van de opdrachtresultaten weer te geven. Zie Opdrachtresultaten voor meer informatie.

Een opdracht bewerken

Een opdracht bijwerken of wijzigen:

  1. Selecteer een opdracht in de werkplek Opdrachten (Jobs).
  2. Bewerk de opdrachtdetails zo nodig en klik op Opslaan wanneer u klaar bent.

Opdrachtrechten definiëren

Als beheerder kunt u beperken welke gebruikers specifieke opdrachten kunnen uitvoeren. Deze rechten definiëren:

  1. Selecteer in de werkplek Opdrachten (Jobs) een opdracht om de details van de opdracht te openen.
  2. Klik op de pagina met opdrachtdetails op Toegang van rol (Role Access).
  3. Selecteer in het dialoogvenster het toegangsniveau dat u voor verschillende rollen wilt inschakelen en klik op Opslaan.
  4. Klik op de pagina met opdrachtdetails op Opslaan.
    Opmerking: Naast het definiëren van de toegang voor rollen tot de opdracht moet u ook rollenrechten toewijzen om de bijbehorende taken uit te voeren in de editor Rollen (Roles). Zie Rollen en rechten voor meer informatie.

Opdrachtinstellingen

Definieer opdrachtinstellingen op basis van de volgende opties.

  • Naam (Name) - Voer een naam voor de opdracht in. Deze wordt ook in de werkplekken Opdrachten (Jobs), Minions en Activiteit (Activity) en in de editor Rollen (Roles) weergegeven.
  • Beschrijving (Description) - Voer een beschrijving voor de opdracht in (optioneel). Deze beschrijving wordt weergegeven in uw lijst met opdrachten in de werkplek Opdrachten (Jobs).
  • Commando (Command) - Specificeer de opdracht die moet worden uitgevoerd, door te kiezen uit:
    • salt - definieer een opdracht die moet worden uitgevoerd op een doelgroep minions.
    • salt-run - definieer een opdracht die moet worden uitgevoerd op een Salt-master of een groep Salt-masters.
    Opmerking: SaltStack Config bevat een besturingselement Opdracht uitvoeren (Run Command) waarmee u één opdracht kunt uitvoeren zonder een herbruikbare opdracht te definiëren. Dit is handig voor het snel uitvoeren van commando's of voor het uitvoeren van eenmalige opdrachten die geen onderdeel zijn van uw dagelijkse werkstroom, bijvoorbeeld bij probleemoplossing of tijdens de eerste configuratie. Zie Een opdracht uitvoeren voor meer informatie.
  • Doelen - Een doel is de groep minions, verspreid over een of meer Salt-masters, waarop het Salt-commando van een opdracht van toepassing is. Een Salt-master kan ook worden beheerd als een minion en kan een doel zijn als deze de minionservice uitvoert. Wanneer salt is geselecteerd in Commando's (Commands), kunt u optioneel de doelgroep minions opgeven waarop de opdracht wordt uitgevoerd. Als het veld leeg wordt gelaten, wordt u gevraagd om elke keer dat de opdracht wordt uitgevoerd, een doel te selecteren.
  • Alle masters - De Salt-master is een centraal knooppunt dat wordt gebruikt om commando's te geven aan minions. Wanneer salt-run is geselecteerd in Commando's (Commands), kunt u opgeven voor welke Salt-master u de opdracht moet uitvoeren. Standaard is Alle Salt-masters (All Salt Masters) geselecteerd. Als u deze optie wilt uitschakelen, wordt het menu Master weergegeven.

    salt-run-opdrachten zijn ook bekend als Salt-runners. Salt-runners zijn modules die worden gebruikt om gemaksfuncties uit te voeren op de Salt-master. Zie Opdrachtinstellingen voor meer informatie over het gebruik van salt-run.

  • Salt-masters (Salt Masters) - Wanneer salt-run is geselecteerd in Commando's (Commands) en Alle masters (All Masters) is uitgeschakeld, wordt het menu Master weergegeven. Klik op dit menu en selecteer de specifieke Salt-master waarvoor u de opdracht wilt uitvoeren. U kunt indien nodig meerdere Salt-masters selecteren.
  • Functie (Function) - Voer een functie in om te bepalen wat er gebeurt wanneer de opdracht wordt uitgevoerd. U kunt één externe uitvoeringsopdracht, een statusbestandsopdracht of een Salt-runneropdracht definiëren. Zie Referentie voor Salt-modules voor een lijst met Salt-functies.
    • Afzonderlijke opdrachten voor externe uitvoering (Single remote execution jobs) - Als u één externe uitvoeringsopdracht wilt definiëren, moet u een functie en eventuele noodzakelijke argumenten opnemen in de opdrachtinstellingen.
    • Statusbestandsopdrachten (State file jobs) - Een statusbestandsopdracht past statussen toe op een doel en kan zijn gebaseerd op minimaal één commando. Een statusfunctie is een functie in een statusmodule die de toepassing van een bepaalde status op een systeem kan beheren. Statusfuncties roepen regelmatig een of meer uitvoeringsmodulen aan om een bepaalde taak uit te voeren. Met highstate worden alle statussen toegepast die in het top-bestand zijn gedefinieerd. U kunt statusbestanden bekijken en toevoegen op de bestandsserver. Zie Bestandsserver.

      Gebruik de functie state.apply om een statusbestand toe te passen op een opdracht. Gebruik de functie state.apply of state.highstate in de opdrachtinstellingen om een highstate uit te voeren.

      Wanneer u een statusaanroep aan een opdracht toevoegt, worden extra velden weergegeven waar u de statusbestanden kunt selecteren die u wilt toepassen. U kunt optionele pillaroverschrijvingen ook doorgeven in JSON-indeling.

      Opmerking: Pillargegevens die op de opdrachtpagina zijn opgegeven, worden samen met de opdracht verzonden en andere geverifieerde minions kunnen deze mogelijk zien. Voor een betere gegevensbescherming kunt u in plaats daarvan gevoelige gegevens toewijzen in standaardpillar. Zie Pillars.

      Zie Salt-documentatie: Hoe gebruik ik Salt-statussen? voor meer informatie over Salt-statussen.

    • Salt-runners (Salt runners) - Een salt-run-opdracht is van toepassing op een Salt-master of een groep Salt-masters. salt-run-opdrachten zijn ook bekend als Salt-runners. Salt-runners zijn modules die worden gebruikt om gemaksfuncties uit te voeren op de Salt-master. U kunt Salt-runners gebruiken om orkestratie uit te voeren, minions op afstand in te schakelen, webhooks aan te roepen en nog veel meer. Ze zijn handig voor het centraal uitvoeren van taken of het uitvoeren van taken vanaf een centraal startpunt. U kunt bijvoorbeeld een highstate toepassen op alle minions die aan een bepaalde Salt-master zijn gekoppeld.

      Gebruik de functie state.orchestrate om een orkestratie-runner-opdracht te configureren. Wanneer u een orkestratieoproep aan een opdracht toevoegt, worden extra velden weergegeven waar u de orkestratiebestanden kunt vermelden die u wilt toepassen. U kunt optionele pillaroverschrijvingen ook doorgeven in JSON-indeling.

      Opmerking: Pillargegevens die op de opdrachtpagina zijn opgegeven, worden samen met de opdracht verzonden en andere geverifieerde minions kunnen deze mogelijk zien. Voor een betere gegevensbescherming kunt u in plaats daarvan gevoelige gegevens toewijzen in standaardpillar. Zie Pillars.

      Zie de Referentie voor Salt-runners voor meer informatie over Salt-runners.

  • Omgevingen (Environments) - Selecteer de omgeving waarin het status- of orkestratiebestand zich bevindt. Dit is een subdirectory van de rootdirectory van de bestandsserver. Zie Bestandsserver.
  • Test (Test (Dry Run)): voer een testopdracht uit en genereer een voorbeeldopdrachtresultaat. Als u Test selecteert, wordt de opdracht niet uitgevoerd en worden er geen wijzigingen aangebracht. Als u deze optie niet selecteert, kunt u ervoor kiezen om de opdracht later als test uit te voeren wanneer u de opdracht uitvoert. Test (Test (Dry Run)) is alleen beschikbaar voor bepaalde functies. Neem contact op met uw beheerder voor meer informatie.