rc1405/sift-saltstack

Salt States for Configuring the SIFT Workstation

[

Managing SIFT with Saltstack

Issues

Please open issues over at the SIFT Repository with prefix '[SALTSTACK]'

Supported Distributions

• Ubuntu 16.04 (Xenial)
• Ubuntu 18.04 (Bionic) - In Testing

Installation

Preferred

Use the sift-cli tool.

Alternate (Manual)

18.04

Status: Beta

There are two primary modes, desktop and server in step 4 the example shows desktop, simply swap that word out for server if you want to see the server mode.

1. Ubuntu 18.04
2. Install SaltStack for 18.04 (Bionic) (See 18.04 instructions below)
3. sudo git clone https://github.com/teamdfir/sift-saltstack.git /srv/salt
4. sudo salt-call --local state.sls sift.desktop pillar='{"sift_version": "dev", "sift_user": "REPLACE_WITH_YOUR_USERNAME"}'

Important: Make sure you replace the REPLACE_WITH_YOUR_USERNAME with your actual username that you are running.

Desktop Note: If you are installing desktop mode, please make sure you run all the commands from a terminal within the Desktop environment.

16.04

It is hightly recommended that you use the sift-cli tool to install, update and upgrade SIFT.

1. Ubuntu 16.04 Machine
2. Install Saltstack (see below)
3. Import the PGP Key - gpg --keyserver hkp://pgp.mit.edu:80 --recv-keys 22598A94
4. Download the latest signed releases files
5. Verify the latest signed release files with GPG
6. Extract the .tar.gz file to /tmp/salt (make sure this README.md is in the root of /tmp/salt)
7. sudo salt-call -l info --local --file-root=/tmp/salt state.apply sift.vm

Customizing the Install

You have full control over what you want to install from the SIFT distro. To really get a good understanding of what you can and cannot do I would encourage you to learn more about Saltstack.

Installing only SIFT Packages

This is intended to replace Step 4 from above. This will install just the deb packages and python packages that makes up the SIFT distro, it will not create any users, change backgrounds, or any other customization of the linux install you are on.

sudo salt-call -l info --local --file-root=/tmp/salt state.apply sift.pkgs

Installing Saltstack

18.04

1. wget -O - https://repo.saltstack.com/apt/ubuntu/18.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
2. echo "deb http://repo.saltstack.com/apt/ubuntu/18.04/amd64/2018.3 bionic main" | sudo tee /etc/apt/sources.list.d/saltstack.list
3. sudo apt-get update
4. sudo apt-get install salt-minion
5. sudo service salt-minion stop

Note: the SIFT install process will disable the minion altogether as we do not need it running as a service

16.04

Reference: http://repo.saltstack.com/#ubuntu

1. wget -O - https://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest/SALTSTACK-GPG-KEY.pub | sudo apt-key add -
2. echo "deb http://repo.saltstack.com/apt/ubuntu/16.04/amd64/latest xenial main" | sudo tee /etc/apt/sources.list.d/saltstack.list
3. sudo apt-get update
4. sudo apt-get install salt-minion
5. sudo service salt-minion stop (Note: the SIFT install process will disable the minion altogether as we do not need it running as a service)