From 3ff36ef225ecc82ee160c2ee3dee639215b7fe5d Mon Sep 17 00:00:00 2001 From: Douglas Thrift Date: Thu, 6 Jun 2019 23:22:46 -0700 Subject: [PATCH] This will be a new major version due to signature changes --- CHANGELOG.md | 28 ++++++++++++++++------------ Makefile | 2 +- README.md | 38 +++++++++++++++++++------------------- RELEASING.md | 6 +++--- 4 files changed, 39 insertions(+), 35 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index bc346f10..b3c0c65f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,7 @@ +v7.0.0 / 2019-06-07 +------------------- +* All actions which return the `"Location"` header now return Locator pointers from their Go functions. + v6.11.0 / 2019-01-08 ------------------- * add policy API to rsc (rsc policy action to see details) @@ -8,29 +12,29 @@ v6.10.1 / 2018-08-24 v6.10.0 / 2018-08-24 -------------------- -* Support with_deleted parameter in instance_types show and index calls. +* Support with\_deleted parameter in instance\_types show and index calls. v6.9.0 / 2018-05-30 ------------------- * add visibility filter to VolumeAttachments index call. * update visibility filter for Images index call. -* add scale_up and scale_down actions to ServerArray. +* add scale\_up and scale\_down actions to ServerArray. v6.8.0 / 2018-03-28 ------------------- -* add api_behavior to VolumeAttachments create call. +* add api\_behavior to VolumeAttachments create call. v6.7.0 / 2018-03-15 ------------------- -* Add skip_deletion flag for Backups.cleanup action -* Update Server resource: change deployment_href on existing server +* Add skip\_deletion flag for Backups.cleanup action +* Update Server resource: change deployment\_href on existing server v6.6.0 / 2017-10-25 ------------------- * Add action/priority to security group rules. * Add source/destination cidr IPs/group names and source start/end port to security group rules. These are currently only available for AzureRM. -* Add cloud_specific_params[service_account] to instances +* Add cloud\_specific\_params[service\_account] to instances v6.5.0 / 2017-07-19 ------------------- @@ -46,7 +50,7 @@ v6.4.1 / 2017-06-20 v6.4.0 / 2017-06-14 ------------------- * Build with Go 1.8 which fixes JSON output to prefer decimal notation rather than scientific notation which was messing - up some IDs (see [encoding/json](https://golang.org/doc/go1.8#encoding_json) in the Go 1.8 Release Notes). + up some IDs (see [encoding/json](https://golang.org/doc/go1.8#encoding\_json) in the Go 1.8 Release Notes). * Add `httpclient.NewPB` constructor which will create an `HTTPClient` from a `ParamBlock` rather than using package global variables which can be unsafe with multiple Goroutines. * Use `context` instead of `golang.org/x/net/context`. @@ -60,7 +64,7 @@ v6.3.0 / 2017-03-02 v6.2.0 / 2016-08-29 ------------------- -* rl10: Added /rll/proc/log_level. +* rl10: Added /rll/proc/log\_level. * Add destroy action for alerts. * Fields for Instance are updated. @@ -73,9 +77,9 @@ v6.1.0 / 2016-08-09 v6.0.0 / 2016-06-28 -------- * Fields for Instance, Route, SshKey, Volume, User, and Permission types are updated. -* Instances#set_custom_lodgement is removed. +* Instances#set\_custom\_lodgement is removed. * InstanceCustomLodgement is removed. -* Added RightScript#delete, Servers#disable_runnable_bindings, Servers#enable_runnable_bindings, ServerArrays#disable_runnable_bindings, and ServerArrays#enable_runnable_bindings, and VolumeSnapshots#copy. +* Added RightScript#delete, Servers#disable\_runnable\_bindings, Servers#enable\_runnable\_bindings, ServerArrays#disable\_runnable\_bindings, and ServerArrays#enable\_runnable\_bindings, and VolumeSnapshots#copy. * Sessions#index now accepts a view argument and the supported views are: default and whoami. * Parameters for Instances#create, Instances#update, Routes#create, Servers#create, Servers#update, ServerArrays#create, and Volumes#create updated. * rl10: Add managed login actions @@ -83,7 +87,7 @@ v6.0.0 / 2016-06-28 v5.0.3 / 2016-04-21 ------------------- * Add --retry flag. Specifies number of retry attempts for non-successful API responses(500, 503, and timeouts only) -* cm15: Add RightScriptAttachment actions. Add RightScript delete and update_source actions. +* cm15: Add RightScriptAttachment actions. Add RightScript delete and update\_source actions. * rl10: Add Docker integration actions. v5.0.2 / 2016-02-05 @@ -127,7 +131,7 @@ v3.1.1 / 2015-08-24 v3.1.0 / 2015-08-14 ------------------- -* Proxy support: honor HTTP_PROXY and HTTPS_PROXY environment variables +* Proxy support: honor HTTP\_PROXY and HTTPS\_PROXY environment variables * Add cloud specific attributes to servers and instances * Fix issue with request timing logging diff --git a/Makefile b/Makefile index 2b38cf3e..30beb75e 100644 --- a/Makefile +++ b/Makefile @@ -34,7 +34,7 @@ NAME=rsc BUCKET=rightscale-binaries ACL=public-read # version for gopkg.in, e.g. v1, v2, ... -GOPKG_VERS=v6 +GOPKG_VERS=v7 GLIDE_VERSION?=v0.13.1 GOOS=$(shell go env GOOS) GOARCH=$(shell go env GOARCH) diff --git a/README.md b/README.md index a1310a52..71f7abcd 100644 --- a/README.md +++ b/README.md @@ -4,8 +4,8 @@ Master [![Build Status](https://travis-ci.org/rightscale/rsc.svg?branch=master)](https://travis-ci.org/rightscale/rsc) -v6.5.0 -[![Build Status](https://travis-ci.org/rightscale/rsc.svg?branch=v6.5.0)](https://travis-ci.org/rightscale/rsc) +v7.0.0 +[![Build Status](https://travis-ci.org/rightscale/rsc.svg?branch=v7.0.0)](https://travis-ci.org/rightscale/rsc) `rsc` provides both a command line tool and a go package for interacting with the RightScale APIs. The currently supported APIs are the RightScale Cloud Management API 1.5 and 1.6 APIs, the @@ -32,26 +32,26 @@ no dependency on any runtime library. Just download the correct version for your architecture and you're good to go. The latest stable versions can be download from: -- MacOS X: `https://binaries.rightscale.com/rsbin/rsc/v6/rsc-darwin-amd64.tgz` -- Windows: `https://binaries.rightscale.com/rsbin/rsc/v6/rsc-windows-amd64.zip` -- Linux: `https://binaries.rightscale.com/rsbin/rsc/v6/rsc-linux-amd64.tgz` -- ODroid/RasPi/armhf: `https://binaries.rightscale.com/rsbin/rsc/v6/rsc-linux-arm.tgz` +- MacOS X: `https://binaries.rightscale.com/rsbin/rsc/v7/rsc-darwin-amd64.tgz` +- Windows: `https://binaries.rightscale.com/rsbin/rsc/v7/rsc-windows-amd64.zip` +- Linux: `https://binaries.rightscale.com/rsbin/rsc/v7/rsc-linux-amd64.tgz` +- ODroid/RasPi/armhf: `https://binaries.rightscale.com/rsbin/rsc/v7/rsc-linux-arm.tgz` As an example the following downloads and runs the MacOS X version: ``` -$ curl https://binaries.rightscale.com/rsbin/rsc/v6/rsc-darwin-amd64.tgz | tar -zxf - -O rsc/rsc > rsc +$ curl https://binaries.rightscale.com/rsbin/rsc/v7/rsc-darwin-amd64.tgz | tar -zxf - -O rsc/rsc > rsc $ chmod +x ./rsc $ ./rsc --version -rsc v6.5.0 - 2017-07-19 00:34:20 - 308f4fcbf12da4b94d6fd683c25dd86deb35237e +rsc v7.0.0 - 2017-07-19 00:34:20 - 308f4fcbf12da4b94d6fd683c25dd86deb35237e ``` #### Versioning -- To download the latest stable use the links with 'v6' in them. -- To download a specific version, replace the 'v6' by the exact version, such as 'v6.5.0'. -- All versions with the same major number (e.g. 'v6') are intended to be "upward" compatible. -- The 'v6' links download a specific version, so `rsc --version` will print something like 'v6.5.0' - and not 'v6'. +- To download the latest stable use the links with 'v7' in them. +- To download a specific version, replace the 'v7' by the exact version, such as 'v7.0.0'. +- All versions with the same major number (e.g. 'v7') are intended to be "upward" compatible. +- The 'v7' links download a specific version, so `rsc --version` will print something like 'v7.0.0' + and not 'v7'. - The latest dev version is 'master'. ### Command Line @@ -320,11 +320,11 @@ sub-package: package `cm15` for CM API 1.5, package `cm16`for CM API `rsc` uses gopkg.in for versioning, this means that you can download the released `rsc` packages as follows: ``` -go get gopkg.in/rightscale/rsc.v6 +go get gopkg.in/rightscale/rsc.v7 ``` and import then in your code with: ```go -import "gopkg.in/rightscale/rsc.v6" +import "gopkg.in/rightscale/rsc.v7" ``` If you intend on contributing, just want to play around with the code or feel adventurous you can download and use the beelding edge version from github which corresponds to the master branch: @@ -523,16 +523,16 @@ The following make targets are useful: #### Your own build of the latest release version -The simple option is `go get gopkg.in/rightscale/rsc.v6`, this will use the checked-in +The simple option is `go get gopkg.in/rightscale/rsc.v7`, this will use the checked-in code-generated files. The more involved option is: ``` mkdir -p $GOPATH/src/gopkg.in/rightscale cd $GOPATH/src/gopkg.in/rightscale -git clone https://github.com/rightscale/rsc.git rsc.v6 -cd rsc.v6 -git checkout v6.2.0 +git clone https://github.com/rightscale/rsc.git rsc.v7 +cd rsc.v7 +git checkout v7.0.0 make depend make ``` diff --git a/RELEASING.md b/RELEASING.md index d5a657e6..610984bf 100644 --- a/RELEASING.md +++ b/RELEASING.md @@ -30,7 +30,7 @@ after releasing. Once the release branch has been pushed and the CI job completes: * Download the binary, run `rsc --version` and make sure the correct version is displayed, on Linux: ``` -curl https://binaries.rightscale.com/rsbin/rsc/v6/rsc-linux-amd64.tgz | tar -zxf - -O rsc/rsc > rsc +curl https://binaries.rightscale.com/rsbin/rsc/v7/rsc-linux-amd64.tgz | tar -zxf - -O rsc/rsc > rsc chmod +x ./rsc ./rsc --version ``` @@ -39,8 +39,8 @@ chmod +x ./rsc mkdir tmp export SAVED_GOPATH=$GOPATH export GOPATH=`pwd`/tmp -go get gopkg.in/rightscale/rsc.v6 -cd tmp/src/gopkg.in/rightscale/rsc.v6 +go get gopkg.in/rightscale/rsc.v7 +cd tmp/src/gopkg.in/rightscale/rsc.v7 git log -2 export GOPATH=$SAVED_GOPATH cd ../../../../..