pivotal-cf/cliaas

Name: cliaas

Owner: Pivotal Cloud Foundry

Description: a iaas agnostic cli to perform blue green ops manager rotations

Created: 2017-02-07 19:03:59.0

Updated: 2018-05-09 17:14:22.0

Pushed: 2018-05-09 17:14:20.0

Homepage:

Size: 6648

Language: Go

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

cliaas

cliaas wraps multiple IaaS-specific libraries to perform some IaaS-agnostic functions. Presently it only supports upgrading a Pivotal Cloud Foundry Operations Manager VM.

Using master from this repo directly may result in breaking the pipelines that consume it. Tracking master is considered unstable. Please use the official releases, or the pcf-pipelines release on Pivotal Network.

Installing

Download the latest release.

Install from source

Requirements:

• glide
• go

r -p $GOPATH/src/github.com/pivotal-cf
clone --depth 1 https://github.com/pivotal-cf/cliaas $GOPATH/src/github.com/pivotal-cf/cliaas
GOPATH/src/github.com/pivotal-cf/cliaas
e install
nstall github.com/pivotal-cf/cliaas/cmd/cliaas

Usage

cliaas -c config.yml replace-vm --identifier vm-identifier

Config

The -c, --config= flag is for specifying a YAML file with IaaS-specific configuration options to use when running a command. The config should only contain the configuration for a single IaaS for now.

AWS-specific Config

> config.yml <<EOF
s:
access_key_id: example-access-key-id
secret_access_key: example-secret-access-key
region: us-east-1
vpc: vpc-12345678
ami: ami-019e4617

• access_key_id: The AWS_ACCESS_KEY_ID to use. Must have the ability to stop VM, start VM, and associate an IP address.
• secret_access_key: The AWS_SECRET_ACCESS_KEY to use. Must have the ability to stop VM, start VM, and associate an IP address.
• region: The AWS region to use.
• vpc: The AWS vpc to use.
• ami: A Pivotal Cloud Foundry Operations Manager AMI, for the new VM in replace-vm.

Notes:

• AWS implementation assumes an Elastic IP is assigned to the Ops Manager VM. If you do not have one allocated to the VM, your replace-vm calls will likely fail on assigning public IP.
• The given identifier will match only if the instance has a state of Running. All other matches with any state other than Running will be ignored.

GCP-specific Config

> config.yml <<EOF
p:
credfile: /tmp/gcp-creds.json
zone: us-east-1
project: my-gcp-projectname
disk_image_url: opsmanager-disk-image-url 

• credfile: The path of your credentials json file issued by gcp.
• zone: the zone in gcp your deployments are in.
• project: the name of the gcp project you're using.
• disk_image_url:: the url of ops manager image provided by pivotal on pivnet

Azure-specific Config

!!! The replace-vm call on Azure will DELETE the current ops manager vm when standing up the new version. This behavior is different than other IaaS' so be warned !!!

> config.yml <<EOF
ure:
vhd_image_url: xxxx
subscription_id: xxxxxx 
client_id: xxxxx
client_secret: xxxxx
tenant_id: xxxxx
resource_group_name: xxxxx
resource_manager_endpoint: xxxxx
storage_account_name: xxxx
storage_account_key: xxxx
storage_container_name: xxxx
storage_url: xxxx
vm_admin_password: xxxxx

• vhd_image_url: xxxxxx //$ the url of ops manager vhd provided by Pivotal, which can be found on pivnet
• subscription_id: xxxxxx //$ azure account show | grep “data: ID”
• client_id: xxxxx //this is the appID output of azure ad app create
• client_secret: xxxxx //this is the password given as a param to the $ azure ad sp create
• tenant_id: xxxxx //$ azure account show | grep “Tenant ID”
• resource_group_name: xxxxx /// this is just the resource group name we wish to target
• storage_account_name: xxxx // this is the name of the storage account you wish to use for storing ops manager vhd
• storage_account_key: xxxx // this is the key to access the above storage account
• storage_container_name: xxxx // the name of the storage container you wish to place the ops manager disk image vhd
• //optional values
• resource_manager_endpoint: xxxx /// option value. defaults to https://management.azure.com/
• storage_url: xxxx // optional storage url to overwrite default value (core.windows.net)
• vm_admin_password: xxxx // optional vm admin password ( a random one will be used if none given)Identifiers

The VM identifier is used to find the VM by name in the IaaS.

Image values in config.yml

• For AWS, the image is an AMI, e.g. ami-019e4617
• For GCP, the image is a disk image url, e.g. https://storage.googleapis.com/ops-manager-us/pcf-gcp-1.9.3.tar.gz
• For Azure, the image is a disk image url, e.g. https://opsmanagereastus.blob.core.windows.net/images/ops-manager-1.10.3.vhd

Developing

nstall github.com/onsi/ginkgo/ginkgo
go -r -p -race -skipPackage integration