Skip to content

Instantly share code, notes, and snippets.

@hillaryj
Last active July 26, 2019 14:59
Show Gist options
  • Save hillaryj/02aa54e6f88bdf099ac5a31ebcc9c524 to your computer and use it in GitHub Desktop.
Save hillaryj/02aa54e6f88bdf099ac5a31ebcc9c524 to your computer and use it in GitHub Desktop.
How to get set up with Cloud.gov on a GSA Mac

Installing a development environment for cloud.gov

  • [Optional] If this is a new GSA-provided laptop, it likely does not come with brew installed. Install brew and other tools via the 18F platform scripts from the 18F laptop repo
    • bash <(curl -s https://raw.githubusercontent.com/18F/laptop/master/laptop)
  • Install CloudFoundry for mac per their docs
    • brew tap cloudfoundry/tap
    • brew install cf-cli
    • brew install cloudfoundry/tap/bosh-cli
    • brew install openssl
  • An existing cloud.gov teammate facilitator will make your account
    • Uses the create-cf-admin script with your GSA email address
  • Verify 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 the BOSH CLI using their instructions for MacOS
    • brew install cloudfoundry/tap/bosh-cli
    • Verify the installation using
      • bosh -v
  • 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
    • Verify AWS CLI installed and is in your path
      • Run aws and helper text should display
  • 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 path
      • cd ~/Downloads
      • mv fly /usr/local/bin/fly
    • Verify using fly -h
  • Install tools for cloud.gov
    • Clone the cg-scripts repo
      • git clone https://github.com/18F/cg-scripts.git

Familiarization with cloud.gov

  • Start with the CloudFoundry Incubator cfdev
    • cf dev start - this process will take a while to get everything set up and deployed to Docker containers
    • eval "$(cf dev bosh env)"
    • cf login -a https://api.dev.cfdev.sh --skip-ssl-validation
    • cf api --skip-ssl-validation https://api.bosh-lite.com
    • cf auth admin admin
  • Learn basic fly commands from the Fly overview

Main tools & topics

Note: Cloud.gov onboarding guide may not be updated away from VirtualBox

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment