Command-line Python Development Environment with SteelScript
Verify you have met the above requirements. Ansible is simply a python library, and can usually be installed via pip install ansible. The other packages require system-level installations.
Windows users note 1: You will need to run the commands from the Git Bash or Cygwin command shell. Git Bash should be included as part of the installation package in the git download.
Windows users note 2: When using Windows as the host machine, the ansible package is not yet fully supported and will fail when trying to pip install it. An extra step is included in Step 4 to workaround this.
Clone this repo via the following command, or using one of the Github GUI clients, click the button: Clone in {platform}:
$ git clone https://github.com/riverbed/steelscript-vm-config.git
$ cd steelscript-vm-config (Wherever your cloned path is for this repo)
$ vagrant plugin install vagrant-vbguest
$ vagrant up
To customize the reports that are available and take a peek under the hood, you can ssh directly into the VM and look at each of the report files:
$ vagrant ssh
vagrant@precise32:~$ cd /steelscript/steepscript_appfwk/config/reports
Changes and edits can now easily be made in the staging area without the need for sudo’ing or worrying about permissions.
A summary of included aliases and commands:
Aliases / Functions | Description |
---|---|
view_err_log | show the apache error log |
view_access_log | show the apache access log |
view_portal_log | show the portal debug log |
cdproject | shortcut to cd /home/vagrant/steelscript_appfwk, the staging directory |
cdwww | shortcut to cd /steelscript/www, the deployed directory |
cdshared | shortcut to cd /vagrant, the shared directory with the host machine. This can be a convenient way to share files between the guest and host. |
run_ipython_notebooks | shortcut to run ipython notebook server (documented below) |
appfwk_dev_server | shortcut to run the django development server in the staging directory |
appfwk_collect_logs | collects and zips up all the appropriate logs to help with debugging VM or Portal issues. |
For further information, see the following descriptions about Portal and how to customize it:
$ vagrant ssh
vagrant@precise32:~$ run_ipython_notebook
[NotebookApp] Created profile dir: u'/home/vagrant/.ipython/profile_default'
[NotebookApp] Serving notebooks from /home/vagrant
[NotebookApp] The IPython Notebook is running at: http://<ipaddress>:8888/
[NotebookApp] Use Control-C to stop this server and shut down all kernels.
[NotebookApp] No web browser found: could not locate runnable browser.
vagrant@precise32:~$ cd /usr/local/share/doc/ipython/examples/notebooks
vagrant@precise32:/usr/local/share/doc/ipython/examples/notebooks$ ipython notebook --ip=`facter ipaddress` --pylab=inline
[NotebookApp] Using existing profile dir: u'/home/vagrant/.ipython/profile_default'
[NotebookApp] Serving notebooks from /usr/local/share/doc/ipython/examples/notebooks
[NotebookApp] The IPython Notebook is running at: http://10.0.2.15:8888/
[NotebookApp] Use Control-C to stop this server and shut down all kernels.
[NotebookApp] No web browser found: could not locate runnable browser.
Note: this notebook will be accessible to anyone on your LAN, if additional security is required, learn more about adding passwords and encryption here in the documentation.