Now that you have reached the end of the Get Started collection, it's time to stop everything and clean up the tutorial artifacts. Start by stopping the job.
»Stop the job
So far you’ve created, run, and modified a job. You also explored Nomad's web interface. The final step in a job's lifecycle is stopping it. Select the way that you would like to stop the example job.
Stop the job using the nomad job stop command.
When you stop a job, it creates an evaluation which is used to stop all the
existing allocations. If you now query the job status, you can see it is now
marked as dead (stopped), indicating that the job has been stopped and Nomad
is no longer running it:
If you wanted to start the job again, you can use the nomad job run command
to run it again.
»Stop the dev agent
In the shell session running your dev agent, use Ctrl-C, the interrupt signal,
to stop the agent.
After interrupting the agent, the logs show the cluster shutting down:
By gracefully leaving, Nomad servers notify their peers they intend to leave. When a server leaves, replication to that server stops. Nomad clients update their status to prevent further tasks from being scheduled and to start migrating any tasks that are already assigned.
»Vagrant clean-up
»Halt the VM
If you are using the Vagrant environment to run Nomad, exit any shell sessions
that you made to the virtual machine. Use the vagrant halt command to stop the
running VM.
At this point, you can start the VM again without having to provision it.
»De-provision the VM
If you don't anticipate using the training VM for a while, and don't mind the
time necessary to provision it, you can deprovision the VM. From the folder that
contains the Vagrantfile you downloaded, use the vagrant destroy command to
deprovision the environment your created. The command verifies that you intend
to perform this activity; enter Y to confirm that you do.
De-provisioning the environment deletes the VM that is created based on the base box.
»Delete the Vagrantfile
If you don't intend to use the Vagrant environment again, you can remove the
Vagrantfile and the nomad-demo folder that you created in the Installation
instructions.
»Remove the base box
If you don't intend to use the Vagrant environment ever again, you can also
delete the downloaded Vagrant base box used to create the VM by running the
vagrant box remove command. Don't worry, if you decide to use the environment
again later, Vagrant re-downloads the base box when you need it.
At this point, you have removed all of the parts that are added by starting up the Vagrantfile.
»Next steps
That concludes the Get Started tutorial collection for Nomad. Hopefully you are excited about the possibilities of Nomad and ready to put this knowledge to use to improve your environment.
You've covered the basics of all the core features of Nomad in this guide. Consider exploring the following resources as next steps.
There are many more Learn Tutorials to provide best practices and guidance for using and operating Nomad in a real-world production setting. Some places you might like to start are:
For developers, consider Deploy and Manage Nomad Jobs, which contains more information about how to run your own workload in Nomad.
For operations, Operating Nomad Clusters, which describes Nomad features that operators need to understand to build and maintain Nomad clusters.
Some of the tutorials require a Nomad cluster. You can create a cluster in AWS using this example Terraform configuration.
