2018-05-22 21:43:36 +02:00
|
|
|
// Copyright 2016-2018, Pulumi Corporation.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
// you may not use this file except in compliance with the License.
|
|
|
|
// You may obtain a copy of the License at
|
|
|
|
//
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
//
|
|
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
// See the License for the specific language governing permissions and
|
|
|
|
// limitations under the License.
|
2018-03-21 18:33:34 +01:00
|
|
|
|
|
|
|
package client
|
|
|
|
|
|
|
|
import (
|
2018-05-08 03:23:03 +02:00
|
|
|
"context"
|
2018-03-21 18:33:34 +01:00
|
|
|
"encoding/json"
|
|
|
|
"fmt"
|
|
|
|
"io"
|
|
|
|
"net/http"
|
|
|
|
"path"
|
2018-03-22 18:42:43 +01:00
|
|
|
"time"
|
2018-03-21 18:33:34 +01:00
|
|
|
|
2018-08-02 23:45:50 +02:00
|
|
|
"github.com/blang/semver"
|
2018-03-21 18:33:34 +01:00
|
|
|
"github.com/pkg/errors"
|
|
|
|
|
|
|
|
"github.com/pulumi/pulumi/pkg/apitype"
|
2018-11-01 16:28:11 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/diag"
|
2018-03-21 18:33:34 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/diag/colors"
|
|
|
|
"github.com/pulumi/pulumi/pkg/engine"
|
|
|
|
"github.com/pulumi/pulumi/pkg/resource/config"
|
|
|
|
"github.com/pulumi/pulumi/pkg/tokens"
|
|
|
|
"github.com/pulumi/pulumi/pkg/util/contract"
|
2019-04-26 20:43:16 +02:00
|
|
|
"github.com/pulumi/pulumi/pkg/util/validation"
|
2018-03-21 18:33:34 +01:00
|
|
|
"github.com/pulumi/pulumi/pkg/workspace"
|
|
|
|
)
|
|
|
|
|
|
|
|
// Client provides a slim wrapper around the Pulumi HTTP/REST API.
|
|
|
|
type Client struct {
|
|
|
|
apiURL string
|
2018-03-22 18:42:43 +01:00
|
|
|
apiToken apiAccessToken
|
2018-04-18 12:19:13 +02:00
|
|
|
apiUser string
|
2018-09-24 23:49:09 +02:00
|
|
|
diag diag.Sink
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// NewClient creates a new Pulumi API client with the given URL and API token.
|
2018-09-24 23:49:09 +02:00
|
|
|
func NewClient(apiURL, apiToken string, d diag.Sink) *Client {
|
2018-03-21 18:33:34 +01:00
|
|
|
return &Client{
|
|
|
|
apiURL: apiURL,
|
2018-03-22 18:42:43 +01:00
|
|
|
apiToken: apiAccessToken(apiToken),
|
2018-09-24 23:49:09 +02:00
|
|
|
diag: d,
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2019-04-26 20:53:00 +02:00
|
|
|
// URL returns the URL of the API endpoint this client interacts with
|
|
|
|
func (pc *Client) URL() string {
|
|
|
|
return pc.apiURL
|
|
|
|
}
|
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
// apiCall makes a raw HTTP request to the Pulumi API using the given method, path, and request body.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) apiCall(ctx context.Context, method, path string, body []byte) (string, *http.Response, error) {
|
2018-09-24 23:49:09 +02:00
|
|
|
return pulumiAPICall(ctx, pc.diag, pc.apiURL, method, path, body, pc.apiToken, httpCallOptions{})
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// restCall makes a REST-style request to the Pulumi API using the given method, path, query object, and request
|
|
|
|
// object. If a response object is provided, the server's response is deserialized into that object.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) restCall(ctx context.Context, method, path string, queryObj, reqObj, respObj interface{}) error {
|
2018-09-24 23:49:09 +02:00
|
|
|
return pulumiRESTCall(ctx, pc.diag, pc.apiURL, method, path, queryObj, reqObj, respObj, pc.apiToken, httpCallOptions{})
|
2018-04-05 21:55:56 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
// restCall makes a REST-style request to the Pulumi API using the given method, path, query object, and request
|
|
|
|
// object. If a response object is provided, the server's response is deserialized into that object.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) restCallWithOptions(ctx context.Context, method, path string, queryObj, reqObj,
|
2018-04-05 21:55:56 +02:00
|
|
|
respObj interface{}, opts httpCallOptions) error {
|
2018-09-24 23:49:09 +02:00
|
|
|
return pulumiRESTCall(ctx, pc.diag, pc.apiURL, method, path, queryObj, reqObj, respObj, pc.apiToken, opts)
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
2018-03-22 18:42:43 +01:00
|
|
|
// updateRESTCall makes a REST-style request to the Pulumi API using the given method, path, query object, and request
|
|
|
|
// object. The call is authorized with the indicated update token. If a response object is provided, the server's
|
|
|
|
// response is deserialized into that object.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) updateRESTCall(ctx context.Context, method, path string, queryObj, reqObj, respObj interface{},
|
2018-05-15 08:44:46 +02:00
|
|
|
token updateAccessToken, httpOptions httpCallOptions) error {
|
2018-03-22 18:42:43 +01:00
|
|
|
|
2018-09-24 23:49:09 +02:00
|
|
|
return pulumiRESTCall(ctx, pc.diag, pc.apiURL, method, path, queryObj, reqObj, respObj, token, httpOptions)
|
2018-03-22 18:42:43 +01:00
|
|
|
}
|
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
// getStackPath returns the API path to for the given stack with the given components joined with path separators
|
|
|
|
// and appended to the stack root.
|
|
|
|
func getStackPath(stack StackIdentifier, components ...string) string {
|
2019-01-18 23:37:05 +01:00
|
|
|
prefix := fmt.Sprintf("/api/stacks/%s/%s/%s", stack.Owner, stack.Project, stack.Stack)
|
|
|
|
return path.Join(append([]string{prefix}, components...)...)
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// getUpdatePath returns the API path to for the given stack with the given components joined with path separators
|
|
|
|
// and appended to the update root.
|
|
|
|
func getUpdatePath(update UpdateIdentifier, components ...string) string {
|
2018-08-30 02:06:48 +02:00
|
|
|
components = append([]string{string(apitype.UpdateUpdate), update.UpdateID}, components...)
|
2018-03-21 18:33:34 +01:00
|
|
|
return getStackPath(update.StackIdentifier, components...)
|
|
|
|
}
|
|
|
|
|
2018-04-18 20:25:16 +02:00
|
|
|
// GetPulumiAccountName returns the user implied by the API token associated with this client.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) GetPulumiAccountName(ctx context.Context) (string, error) {
|
2018-04-18 12:19:13 +02:00
|
|
|
if pc.apiUser == "" {
|
|
|
|
resp := struct {
|
|
|
|
GitHubLogin string `json:"githubLogin"`
|
|
|
|
}{}
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "GET", "/api/user", nil, nil, &resp); err != nil {
|
2018-04-18 12:19:13 +02:00
|
|
|
return "", err
|
|
|
|
}
|
|
|
|
|
2018-04-18 20:25:16 +02:00
|
|
|
if resp.GitHubLogin == "" {
|
|
|
|
return "", errors.New("unexpected response from server")
|
|
|
|
}
|
|
|
|
|
2018-04-18 12:19:13 +02:00
|
|
|
pc.apiUser = resp.GitHubLogin
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
2018-04-18 12:19:13 +02:00
|
|
|
|
|
|
|
return pc.apiUser, nil
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// DownloadPlugin downloads the indicated plugin from the Pulumi API.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) DownloadPlugin(ctx context.Context, info workspace.PluginInfo, os,
|
|
|
|
arch string) (io.ReadCloser, int64, error) {
|
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
endpoint := fmt.Sprintf("/releases/plugins/pulumi-%s-%s-v%s-%s-%s.tar.gz",
|
|
|
|
info.Kind, info.Name, info.Version, os, arch)
|
2018-05-08 03:23:03 +02:00
|
|
|
_, resp, err := pc.apiCall(ctx, "GET", endpoint, nil)
|
2018-03-21 18:33:34 +01:00
|
|
|
if err != nil {
|
|
|
|
return nil, 0, err
|
|
|
|
}
|
|
|
|
return resp.Body, resp.ContentLength, nil
|
|
|
|
}
|
|
|
|
|
2018-08-02 23:45:50 +02:00
|
|
|
// GetCLIVersionInfo asks the service for information about versions of the CLI (the newest version as well as the
|
|
|
|
// oldest version before the CLI should warn about an upgrade).
|
|
|
|
func (pc *Client) GetCLIVersionInfo(ctx context.Context) (semver.Version, semver.Version, error) {
|
|
|
|
var versionInfo apitype.CLIVersionResponse
|
|
|
|
|
|
|
|
if err := pc.restCall(ctx, "GET", "/api/cli/version", nil, nil, &versionInfo); err != nil {
|
|
|
|
return semver.Version{}, semver.Version{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
latestSem, err := semver.ParseTolerant(versionInfo.LatestVersion)
|
|
|
|
if err != nil {
|
|
|
|
return semver.Version{}, semver.Version{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
oldestSem, err := semver.ParseTolerant(versionInfo.OldestWithoutWarning)
|
|
|
|
if err != nil {
|
|
|
|
return semver.Version{}, semver.Version{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return latestSem, oldestSem, nil
|
|
|
|
}
|
|
|
|
|
2018-09-14 05:54:42 +02:00
|
|
|
// ListStacks lists all stacks the current user has access to, optionally filtered by project.
|
2019-01-25 01:54:32 +01:00
|
|
|
func (pc *Client) ListStacks(ctx context.Context, projectFilter *string) ([]apitype.StackSummary, error) {
|
2018-05-08 03:23:03 +02:00
|
|
|
|
2018-09-14 05:54:42 +02:00
|
|
|
var resp apitype.ListStacksResponse
|
2018-05-22 01:17:12 +02:00
|
|
|
var queryFilter interface{}
|
|
|
|
if projectFilter != nil {
|
|
|
|
queryFilter = struct {
|
|
|
|
ProjectFilter string `url:"project"`
|
2019-01-25 01:54:32 +01:00
|
|
|
}{ProjectFilter: *projectFilter}
|
2018-05-22 01:17:12 +02:00
|
|
|
}
|
2018-04-18 12:19:13 +02:00
|
|
|
|
2018-09-14 05:54:42 +02:00
|
|
|
if err := pc.restCall(ctx, "GET", "/api/user/stacks", queryFilter, nil, &resp); err != nil {
|
2018-05-22 01:17:12 +02:00
|
|
|
return nil, err
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
2018-04-18 12:19:13 +02:00
|
|
|
|
2018-09-14 05:54:42 +02:00
|
|
|
return resp.Stacks, nil
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
2019-04-26 20:43:16 +02:00
|
|
|
var (
|
|
|
|
// ErrNoPreviousDeployment is returned when there isn't a previous deployment.
|
|
|
|
ErrNoPreviousDeployment = errors.New("no previous deployment")
|
|
|
|
)
|
|
|
|
|
2018-04-27 01:13:52 +02:00
|
|
|
// GetLatestConfiguration returns the configuration for the latest deployment of a given stack.
|
|
|
|
func (pc *Client) GetLatestConfiguration(ctx context.Context, stackID StackIdentifier) (config.Map, error) {
|
|
|
|
latest := struct {
|
|
|
|
Info apitype.UpdateInfo `json:"info,allowEmpty"`
|
|
|
|
}{}
|
|
|
|
|
|
|
|
if err := pc.restCall(ctx, "GET", getStackPath(stackID, "updates", "latest"), nil, nil, &latest); err != nil {
|
|
|
|
if restErr, ok := err.(*apitype.ErrorResponse); ok {
|
|
|
|
if restErr.Code == http.StatusNotFound {
|
2019-04-26 20:43:16 +02:00
|
|
|
return nil, ErrNoPreviousDeployment
|
2018-04-27 01:13:52 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
cfg := make(config.Map)
|
|
|
|
for k, v := range latest.Info.Config {
|
|
|
|
newKey, err := config.ParseKey(k)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
if v.Secret {
|
|
|
|
cfg[newKey] = config.NewSecureValue(v.String)
|
|
|
|
} else {
|
|
|
|
cfg[newKey] = config.NewValue(v.String)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
return cfg, nil
|
|
|
|
}
|
|
|
|
|
2018-03-28 21:47:12 +02:00
|
|
|
// GetStack retrieves the stack with the given name.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) GetStack(ctx context.Context, stackID StackIdentifier) (apitype.Stack, error) {
|
2018-03-28 21:47:12 +02:00
|
|
|
var stack apitype.Stack
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "GET", getStackPath(stackID), nil, nil, &stack); err != nil {
|
2018-03-28 21:47:12 +02:00
|
|
|
return apitype.Stack{}, err
|
|
|
|
}
|
|
|
|
return stack, nil
|
|
|
|
}
|
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
// CreateStack creates a stack with the given cloud and stack name in the scope of the indicated project.
|
2018-04-09 18:31:46 +02:00
|
|
|
func (pc *Client) CreateStack(
|
2018-10-24 22:50:35 +02:00
|
|
|
ctx context.Context, stackID StackIdentifier, tags map[apitype.StackTagName]string) (apitype.Stack, error) {
|
2018-04-11 19:08:32 +02:00
|
|
|
// Validate names and tags.
|
2019-04-26 20:43:16 +02:00
|
|
|
if err := validation.ValidateStackProperties(stackID.Stack, tags); err != nil {
|
2018-04-11 19:08:32 +02:00
|
|
|
return apitype.Stack{}, errors.Wrap(err, "validating stack properties")
|
|
|
|
}
|
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
stack := apitype.Stack{
|
2019-01-18 23:37:05 +01:00
|
|
|
StackName: tokens.QName(stackID.Stack),
|
|
|
|
ProjectName: stackID.Project,
|
|
|
|
OrgName: stackID.Owner,
|
|
|
|
Tags: tags,
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
createStackReq := apitype.CreateStackRequest{
|
2018-05-22 01:17:12 +02:00
|
|
|
StackName: stackID.Stack,
|
2018-04-09 18:31:46 +02:00
|
|
|
Tags: tags,
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
2018-10-24 22:50:35 +02:00
|
|
|
var createStackResp apitype.CreateStackResponse
|
2019-01-18 23:37:05 +01:00
|
|
|
|
|
|
|
endpoint := fmt.Sprintf("/api/stacks/%s/%s", stackID.Owner, stackID.Project)
|
2018-05-22 01:17:12 +02:00
|
|
|
if err := pc.restCall(
|
2019-01-18 23:37:05 +01:00
|
|
|
ctx, "POST", endpoint, nil, &createStackReq, &createStackResp); err != nil {
|
2018-05-22 01:17:12 +02:00
|
|
|
return apitype.Stack{}, err
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
return stack, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// DeleteStack deletes the indicated stack. If force is true, the stack is deleted even if it contains resources.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) DeleteStack(ctx context.Context, stack StackIdentifier, force bool) (bool, error) {
|
2018-03-21 18:33:34 +01:00
|
|
|
path := getStackPath(stack)
|
2019-02-07 04:07:31 +01:00
|
|
|
queryObj := struct {
|
|
|
|
Force bool `url:"force"`
|
|
|
|
}{
|
|
|
|
Force: force,
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
2019-02-07 04:07:31 +01:00
|
|
|
err := pc.restCall(ctx, "DELETE", path, queryObj, nil, nil)
|
|
|
|
return isStackHasResourcesError(err), err
|
|
|
|
}
|
|
|
|
|
|
|
|
func isStackHasResourcesError(err error) bool {
|
|
|
|
if err == nil {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
|
|
|
|
errRsp, ok := err.(*apitype.ErrorResponse)
|
|
|
|
if !ok {
|
|
|
|
return false
|
|
|
|
}
|
|
|
|
|
|
|
|
return errRsp.Code == 400 && errRsp.Message == "Bad Request: Stack still contains resources."
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// EncryptValue encrypts a plaintext value in the context of the indicated stack.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) EncryptValue(ctx context.Context, stack StackIdentifier, plaintext []byte) ([]byte, error) {
|
2018-03-21 18:33:34 +01:00
|
|
|
req := apitype.EncryptValueRequest{Plaintext: plaintext}
|
|
|
|
var resp apitype.EncryptValueResponse
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "POST", getStackPath(stack, "encrypt"), nil, &req, &resp); err != nil {
|
2018-03-21 18:33:34 +01:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return resp.Ciphertext, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// DecryptValue decrypts a ciphertext value in the context of the indicated stack.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) DecryptValue(ctx context.Context, stack StackIdentifier, ciphertext []byte) ([]byte, error) {
|
2018-03-21 18:33:34 +01:00
|
|
|
req := apitype.DecryptValueRequest{Ciphertext: ciphertext}
|
|
|
|
var resp apitype.DecryptValueResponse
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "POST", getStackPath(stack, "decrypt"), nil, &req, &resp); err != nil {
|
2018-03-21 18:33:34 +01:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
return resp.Plaintext, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// GetStackUpdates returns all updates to the indicated stack.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) GetStackUpdates(ctx context.Context, stack StackIdentifier) ([]apitype.UpdateInfo, error) {
|
2018-03-21 18:33:34 +01:00
|
|
|
var response apitype.GetHistoryResponse
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "GET", getStackPath(stack, "updates"), nil, nil, &response); err != nil {
|
2018-03-21 18:33:34 +01:00
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return response.Updates, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// ExportStackDeployment exports the indicated stack's deployment as a raw JSON message.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) ExportStackDeployment(ctx context.Context,
|
|
|
|
stack StackIdentifier) (apitype.UntypedDeployment, error) {
|
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
var resp apitype.ExportStackResponse
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "GET", getStackPath(stack, "export"), nil, nil, &resp); err != nil {
|
2018-04-18 01:01:52 +02:00
|
|
|
return apitype.UntypedDeployment{}, err
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
2018-04-18 01:01:52 +02:00
|
|
|
return apitype.UntypedDeployment(resp), nil
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// ImportStackDeployment imports a new deployment into the indicated stack.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) ImportStackDeployment(ctx context.Context, stack StackIdentifier,
|
2018-06-03 23:30:51 +02:00
|
|
|
deployment *apitype.UntypedDeployment) (UpdateIdentifier, error) {
|
2018-05-08 03:23:03 +02:00
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
var resp apitype.ImportStackResponse
|
2018-06-03 23:30:51 +02:00
|
|
|
if err := pc.restCall(ctx, "POST", getStackPath(stack, "import"), nil, deployment, &resp); err != nil {
|
2018-03-21 18:33:34 +01:00
|
|
|
return UpdateIdentifier{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return UpdateIdentifier{
|
|
|
|
StackIdentifier: stack,
|
2018-08-30 02:06:48 +02:00
|
|
|
UpdateKind: apitype.UpdateUpdate,
|
2018-03-21 18:33:34 +01:00
|
|
|
UpdateID: resp.UpdateID,
|
|
|
|
}, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// CreateUpdate creates a new update for the indicated stack with the given kind and assorted options. If the update
|
|
|
|
// requires that the Pulumi program is uploaded, the provided getContents callback will be invoked to fetch the
|
|
|
|
// contents of the Pulumi program.
|
2018-04-14 07:26:01 +02:00
|
|
|
func (pc *Client) CreateUpdate(
|
2018-11-01 16:28:11 +01:00
|
|
|
ctx context.Context, kind apitype.UpdateKind, stack StackIdentifier, proj *workspace.Project, cfg config.Map,
|
|
|
|
m apitype.UpdateMetadata, opts engine.UpdateOptions, dryRun bool) (UpdateIdentifier, error) {
|
2018-03-21 18:33:34 +01:00
|
|
|
|
|
|
|
// First create the update program request.
|
|
|
|
wireConfig := make(map[string]apitype.ConfigValue)
|
|
|
|
for k, cv := range cfg {
|
|
|
|
v, err := cv.Value(config.NopDecrypter)
|
|
|
|
contract.AssertNoError(err)
|
|
|
|
|
2018-08-22 19:55:51 +02:00
|
|
|
wireConfig[k.String()] = apitype.ConfigValue{
|
2018-03-21 18:33:34 +01:00
|
|
|
String: v,
|
|
|
|
Secret: cv.Secure(),
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
description := ""
|
2018-11-01 16:28:11 +01:00
|
|
|
if proj.Description != nil {
|
|
|
|
description = *proj.Description
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
2018-04-14 07:26:01 +02:00
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
updateRequest := apitype.UpdateProgramRequest{
|
2018-11-01 16:28:11 +01:00
|
|
|
Name: string(proj.Name),
|
|
|
|
Runtime: proj.Runtime.Name(),
|
|
|
|
Main: proj.Main,
|
2018-03-21 18:33:34 +01:00
|
|
|
Description: description,
|
|
|
|
Config: wireConfig,
|
|
|
|
Options: apitype.UpdateOptions{
|
|
|
|
Analyzers: opts.Analyzers,
|
|
|
|
Color: colors.Raw, // force raw colorization, we handle colorization in the CLI
|
2018-04-14 07:26:01 +02:00
|
|
|
DryRun: dryRun,
|
2018-03-21 18:33:34 +01:00
|
|
|
Parallel: opts.Parallel,
|
|
|
|
ShowConfig: false, // This is a legacy option now, the engine will always emit config information
|
|
|
|
ShowReplacementSteps: false, // This is a legacy option now, the engine will always emit this information
|
|
|
|
ShowSames: false, // This is a legacy option now, the engine will always emit this information
|
|
|
|
},
|
|
|
|
Metadata: m,
|
|
|
|
}
|
|
|
|
|
|
|
|
// Create the initial update object.
|
2018-04-17 00:34:59 +02:00
|
|
|
var endpoint string
|
|
|
|
switch kind {
|
2018-08-30 02:06:48 +02:00
|
|
|
case apitype.UpdateUpdate:
|
2018-08-03 05:13:12 +02:00
|
|
|
endpoint = "update"
|
2018-08-30 02:06:48 +02:00
|
|
|
case apitype.PreviewUpdate:
|
2018-05-09 05:55:51 +02:00
|
|
|
endpoint = "preview"
|
2018-08-30 02:06:48 +02:00
|
|
|
case apitype.RefreshUpdate:
|
2018-05-17 20:44:39 +02:00
|
|
|
endpoint = "refresh"
|
2018-08-30 02:06:48 +02:00
|
|
|
case apitype.DestroyUpdate:
|
2018-04-17 00:34:59 +02:00
|
|
|
endpoint = "destroy"
|
|
|
|
default:
|
|
|
|
contract.Failf("Unknown kind: %s", kind)
|
|
|
|
}
|
|
|
|
|
|
|
|
path := getStackPath(stack, endpoint)
|
2018-03-21 18:33:34 +01:00
|
|
|
var updateResponse apitype.UpdateProgramResponse
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "POST", path, nil, &updateRequest, &updateResponse); err != nil {
|
2018-03-21 18:33:34 +01:00
|
|
|
return UpdateIdentifier{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return UpdateIdentifier{
|
|
|
|
StackIdentifier: stack,
|
|
|
|
UpdateKind: kind,
|
|
|
|
UpdateID: updateResponse.UpdateID,
|
|
|
|
}, nil
|
|
|
|
}
|
|
|
|
|
2019-03-14 23:32:10 +01:00
|
|
|
func (pc *Client) RenameStack(ctx context.Context, stack StackIdentifier, newName string) error {
|
|
|
|
req := apitype.StackRenameRequest{
|
|
|
|
NewName: newName,
|
|
|
|
}
|
|
|
|
var resp apitype.ImportStackResponse
|
|
|
|
|
|
|
|
return pc.restCall(ctx, "POST", getStackPath(stack, "rename"), nil, &req, &resp)
|
|
|
|
}
|
|
|
|
|
2018-03-22 18:42:43 +01:00
|
|
|
// StartUpdate starts the indicated update. It returns the new version of the update's target stack and the token used
|
2018-04-09 18:31:46 +02:00
|
|
|
// to authenticate operations on the update if any. Replaces the stack's tags with the updated set.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) StartUpdate(ctx context.Context, update UpdateIdentifier,
|
|
|
|
tags map[apitype.StackTagName]string) (int, string, error) {
|
|
|
|
|
2018-04-11 19:08:32 +02:00
|
|
|
// Validate names and tags.
|
2019-04-26 20:43:16 +02:00
|
|
|
if err := validation.ValidateStackProperties(update.StackIdentifier.Stack, tags); err != nil {
|
2018-04-11 19:08:32 +02:00
|
|
|
return 0, "", errors.Wrap(err, "validating stack properties")
|
|
|
|
}
|
|
|
|
|
2018-04-09 18:31:46 +02:00
|
|
|
req := apitype.StartUpdateRequest{
|
|
|
|
Tags: tags,
|
|
|
|
}
|
|
|
|
|
2018-03-21 18:33:34 +01:00
|
|
|
var resp apitype.StartUpdateResponse
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "POST", getUpdatePath(update), nil, req, &resp); err != nil {
|
2018-03-22 18:42:43 +01:00
|
|
|
return 0, "", err
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
2018-03-22 18:42:43 +01:00
|
|
|
return resp.Version, resp.Token, nil
|
2018-03-21 18:33:34 +01:00
|
|
|
}
|
|
|
|
|
2018-04-21 00:48:23 +02:00
|
|
|
// GetUpdateEvents returns all events, taking an optional continuation token from a previous call.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) GetUpdateEvents(ctx context.Context, update UpdateIdentifier,
|
|
|
|
continuationToken *string) (apitype.UpdateResults, error) {
|
|
|
|
|
2018-04-21 00:48:23 +02:00
|
|
|
path := getUpdatePath(update)
|
|
|
|
if continuationToken != nil {
|
|
|
|
path += fmt.Sprintf("?continuationToken=%s", *continuationToken)
|
|
|
|
}
|
2018-03-21 18:33:34 +01:00
|
|
|
|
|
|
|
var results apitype.UpdateResults
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCall(ctx, "GET", path, nil, nil, &results); err != nil {
|
2018-03-21 18:33:34 +01:00
|
|
|
return apitype.UpdateResults{}, err
|
|
|
|
}
|
|
|
|
|
|
|
|
return results, nil
|
|
|
|
}
|
2018-03-22 18:42:43 +01:00
|
|
|
|
|
|
|
// RenewUpdateLease renews the indicated update lease for the given duration.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) RenewUpdateLease(ctx context.Context, update UpdateIdentifier, token string,
|
|
|
|
duration time.Duration) (string, error) {
|
|
|
|
|
2018-03-22 18:42:43 +01:00
|
|
|
req := apitype.RenewUpdateLeaseRequest{
|
|
|
|
Token: token,
|
|
|
|
Duration: int(duration / time.Second),
|
|
|
|
}
|
|
|
|
var resp apitype.RenewUpdateLeaseResponse
|
2018-05-15 08:44:46 +02:00
|
|
|
|
|
|
|
// While renewing a lease uses POST, it is safe to send multiple requests (consider that we do this multiple times
|
|
|
|
// during a long running update). Since we would fail our update operation if we can't renew our lease, we'll retry
|
|
|
|
// these POST operations.
|
2018-05-08 03:23:03 +02:00
|
|
|
if err := pc.restCallWithOptions(ctx, "POST", getUpdatePath(update, "renew_lease"), nil,
|
2018-04-05 21:55:56 +02:00
|
|
|
req, &resp, httpCallOptions{RetryAllMethods: true}); err != nil {
|
2018-03-22 18:42:43 +01:00
|
|
|
return "", err
|
|
|
|
}
|
|
|
|
return resp.Token, nil
|
|
|
|
}
|
|
|
|
|
|
|
|
// InvalidateUpdateCheckpoint invalidates the checkpoint for the indicated update.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) InvalidateUpdateCheckpoint(ctx context.Context, update UpdateIdentifier, token string) error {
|
2018-03-22 18:42:43 +01:00
|
|
|
req := apitype.PatchUpdateCheckpointRequest{
|
|
|
|
IsInvalid: true,
|
|
|
|
}
|
2018-05-15 08:44:46 +02:00
|
|
|
|
|
|
|
// It is safe to retry this PATCH operation, because it is logically idempotent.
|
|
|
|
return pc.updateRESTCall(ctx, "PATCH", getUpdatePath(update, "checkpoint"), nil, req, nil,
|
|
|
|
updateAccessToken(token), httpCallOptions{RetryAllMethods: true})
|
2018-03-22 18:42:43 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
// PatchUpdateCheckpoint patches the checkpoint for the indicated update with the given contents.
|
Implement more precise delete-before-replace semantics. (#2369)
This implements the new algorithm for deciding which resources must be
deleted due to a delete-before-replace operation.
We need to compute the set of resources that may be replaced by a
change to the resource under consideration. We do this by taking the
complete set of transitive dependents on the resource under
consideration and removing any resources that would not be replaced by
changes to their dependencies. We determine whether or not a resource
may be replaced by substituting unknowns for input properties that may
change due to deletion of the resources their value depends on and
calling the resource provider's Diff method.
This is perhaps clearer when described by example. Consider the
following dependency graph:
A
__|__
B C
| _|_
D E F
In this graph, all of B, C, D, E, and F transitively depend on A. It may
be the case, however, that changes to the specific properties of any of
those resources R that would occur if a resource on the path to A were
deleted and recreated may not cause R to be replaced. For example, the
edge from B to A may be a simple dependsOn edge such that a change to
B does not actually influence any of B's input properties. In that case,
neither B nor D would need to be deleted before A could be deleted.
In order to make the above algorithm a reality, the resource monitor
interface has been updated to include a map that associates an input
property key with the list of resources that input property depends on.
Older clients of the resource monitor will leave this map empty, in
which case all input properties will be treated as depending on all
dependencies of the resource. This is probably overly conservative, but
it is less conservative than what we currently implement, and is
certainly correct.
2019-01-28 18:46:30 +01:00
|
|
|
func (pc *Client) PatchUpdateCheckpoint(ctx context.Context, update UpdateIdentifier, deployment *apitype.DeploymentV3,
|
2018-05-08 03:23:03 +02:00
|
|
|
token string) error {
|
|
|
|
|
2018-07-27 23:22:16 +02:00
|
|
|
rawDeployment, err := json.Marshal(deployment)
|
2018-04-18 00:58:20 +02:00
|
|
|
if err != nil {
|
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
2018-03-22 18:42:43 +01:00
|
|
|
req := apitype.PatchUpdateCheckpointRequest{
|
Implement more precise delete-before-replace semantics. (#2369)
This implements the new algorithm for deciding which resources must be
deleted due to a delete-before-replace operation.
We need to compute the set of resources that may be replaced by a
change to the resource under consideration. We do this by taking the
complete set of transitive dependents on the resource under
consideration and removing any resources that would not be replaced by
changes to their dependencies. We determine whether or not a resource
may be replaced by substituting unknowns for input properties that may
change due to deletion of the resources their value depends on and
calling the resource provider's Diff method.
This is perhaps clearer when described by example. Consider the
following dependency graph:
A
__|__
B C
| _|_
D E F
In this graph, all of B, C, D, E, and F transitively depend on A. It may
be the case, however, that changes to the specific properties of any of
those resources R that would occur if a resource on the path to A were
deleted and recreated may not cause R to be replaced. For example, the
edge from B to A may be a simple dependsOn edge such that a change to
B does not actually influence any of B's input properties. In that case,
neither B nor D would need to be deleted before A could be deleted.
In order to make the above algorithm a reality, the resource monitor
interface has been updated to include a map that associates an input
property key with the list of resources that input property depends on.
Older clients of the resource monitor will leave this map empty, in
which case all input properties will be treated as depending on all
dependencies of the resource. This is probably overly conservative, but
it is less conservative than what we currently implement, and is
certainly correct.
2019-01-28 18:46:30 +01:00
|
|
|
Version: 3,
|
2018-04-18 00:58:20 +02:00
|
|
|
Deployment: rawDeployment,
|
2018-03-22 18:42:43 +01:00
|
|
|
}
|
2018-05-15 08:44:46 +02:00
|
|
|
|
|
|
|
// It is safe to retry this PATCH operation, because it is logically idempotent, since we send the entire
|
|
|
|
// deployment instead of a set of changes to apply.
|
|
|
|
return pc.updateRESTCall(ctx, "PATCH", getUpdatePath(update, "checkpoint"), nil, req, nil,
|
2018-10-23 23:11:40 +02:00
|
|
|
updateAccessToken(token), httpCallOptions{RetryAllMethods: true, GzipCompress: true})
|
2018-03-22 18:42:43 +01:00
|
|
|
}
|
|
|
|
|
2018-04-19 19:09:32 +02:00
|
|
|
// CancelUpdate cancels the indicated update.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) CancelUpdate(ctx context.Context, update UpdateIdentifier) error {
|
2018-05-15 08:44:46 +02:00
|
|
|
|
|
|
|
// It is safe to retry this PATCH operation, because it is logically idempotent.
|
|
|
|
return pc.restCallWithOptions(ctx, "POST", getUpdatePath(update, "cancel"), nil, nil, nil,
|
|
|
|
httpCallOptions{RetryAllMethods: true})
|
2018-04-19 19:09:32 +02:00
|
|
|
}
|
|
|
|
|
2018-03-22 18:42:43 +01:00
|
|
|
// CompleteUpdate completes the indicated update with the given status.
|
2018-05-08 03:23:03 +02:00
|
|
|
func (pc *Client) CompleteUpdate(ctx context.Context, update UpdateIdentifier, status apitype.UpdateStatus,
|
|
|
|
token string) error {
|
|
|
|
|
2018-03-22 18:42:43 +01:00
|
|
|
req := apitype.CompleteUpdateRequest{
|
|
|
|
Status: status,
|
|
|
|
}
|
2018-05-15 08:44:46 +02:00
|
|
|
|
|
|
|
// It is safe to retry this PATCH operation, because it is logically idempotent.
|
|
|
|
return pc.updateRESTCall(ctx, "POST", getUpdatePath(update, "complete"), nil, req, nil,
|
|
|
|
updateAccessToken(token), httpCallOptions{RetryAllMethods: true})
|
2018-03-22 18:42:43 +01:00
|
|
|
}
|
|
|
|
|
2018-11-09 19:01:29 +01:00
|
|
|
// RecordEngineEvent posts an engine event to the Pulumi service.
|
|
|
|
func (pc *Client) RecordEngineEvent(
|
|
|
|
ctx context.Context, update UpdateIdentifier, event apitype.EngineEvent, token string) error {
|
2018-12-04 23:46:32 +01:00
|
|
|
callOpts := httpCallOptions{
|
|
|
|
GzipCompress: true,
|
|
|
|
RetryAllMethods: true,
|
|
|
|
}
|
2018-11-09 19:01:29 +01:00
|
|
|
return pc.updateRESTCall(
|
|
|
|
ctx, "POST", getUpdatePath(update, "events"),
|
|
|
|
nil, event, nil,
|
2018-12-04 23:46:32 +01:00
|
|
|
updateAccessToken(token), callOpts)
|
2018-11-09 19:01:29 +01:00
|
|
|
}
|
2019-01-04 22:23:47 +01:00
|
|
|
|
|
|
|
// UpdateStackTags updates the stacks's tags, replacing all existing tags.
|
|
|
|
func (pc *Client) UpdateStackTags(
|
|
|
|
ctx context.Context, stack StackIdentifier, tags map[apitype.StackTagName]string) error {
|
|
|
|
|
|
|
|
// Validate stack tags.
|
2019-04-26 20:43:16 +02:00
|
|
|
if err := validation.ValidateStackTags(tags); err != nil {
|
2019-01-04 22:23:47 +01:00
|
|
|
return err
|
|
|
|
}
|
|
|
|
|
|
|
|
return pc.restCall(ctx, "PATCH", getStackPath(stack, "tags"), nil, tags, nil)
|
|
|
|
}
|