Setting up a local development environment
This guide is useful for setting up a local development environment for cloud.gov platform operations and includes a number of command-line tools used in the development and maintenance of the cloud.gov system.
This guide assumes you are using a standard GSA-provided Mac OS development asset for specifying commands and packages.
Setting up a local development environment
Pre-install for brand new machines
- Install
brew
- Note: If this is a new GSA-provided laptop, it likely does not come with
brew
installed. Installbrew
and other tools via the 18F platform scripts from the 18F laptop repo (or manually if you have strong preferences about the laptop script) bash <(curl -s https://raw.githubusercontent.com/18F/laptop/master/laptop)
- Note: If this is a new GSA-provided laptop, it likely does not come with
Install open-source CloudFoundry
- Install CloudFoundry for Mac per CF docs:
brew tap cloudfoundry/tap
brew install cf-cli
brew install cloudfoundry/tap/bosh-cli
brew install openssl
- An existing cloud.gov teammate will make your cloud.gov admin account
- They will use the
create-cf-admin
script fromcg-scripts
with your GSA email address
- They will use the
- Verify cloud.gov account setup and CloudFoundry installation via the CLI
cf login -a api.fr.cloud.gov --sso
cf orgs
- As a cloud.gov team member, you should have a very giant list of organizations
- If you have none or one (e.g. sandbox) org, contact your facilitator
Install Bosh
- Install the Bosh CLI using their instructions for MacOS
brew install cloudfoundry/tap/bosh-cli
- Verify the installation using
bosh -v
Install Concource & Fly
- Install the Concourse
fly
CLI- Download the
fly
binary zip for MacOS from https://concourse-ci.org/ - Extract the binary and move it to
/usr/local/bin/fly
so it’s in your pathcd ~/Downloads
mv fly /usr/local/bin/fly
- Verify using
fly -h
- Download the
Install Terraform
- Install Terraform and other tools per cg-provision
brew install terraform
brew install awscli
brew install jq
- Verify Terraform installed and is in your path
- Run
terraform
and helper text should display
- Run
- Verify AWS CLI installed and is in your path
- Run
aws
and helper text should display
- Run
Install cloud.gov dev scripts
- Install cloud.gov dev scripts by cloning the
cg-scripts
repogit clone https://github.com/18F/cg-scripts.git
- Note: may also be done via Github Desktop