github.com/sathish1597/hashicorp-terraform@v0.11.12-beta1/backend/remote-state/s3/backend.go (about) 1 package s3 2 3 import ( 4 "context" 5 "fmt" 6 "strings" 7 8 "github.com/aws/aws-sdk-go/service/dynamodb" 9 "github.com/aws/aws-sdk-go/service/s3" 10 "github.com/hashicorp/terraform/backend" 11 "github.com/hashicorp/terraform/helper/schema" 12 13 terraformAWS "github.com/terraform-providers/terraform-provider-aws/aws" 14 ) 15 16 // New creates a new backend for S3 remote state. 17 func New() backend.Backend { 18 s := &schema.Backend{ 19 Schema: map[string]*schema.Schema{ 20 "bucket": { 21 Type: schema.TypeString, 22 Required: true, 23 Description: "The name of the S3 bucket", 24 }, 25 26 "key": { 27 Type: schema.TypeString, 28 Required: true, 29 Description: "The path to the state file inside the bucket", 30 ValidateFunc: func(v interface{}, s string) ([]string, []error) { 31 // s3 will strip leading slashes from an object, so while this will 32 // technically be accepted by s3, it will break our workspace hierarchy. 33 if strings.HasPrefix(v.(string), "/") { 34 return nil, []error{fmt.Errorf("key must not start with '/'")} 35 } 36 return nil, nil 37 }, 38 }, 39 40 "region": { 41 Type: schema.TypeString, 42 Required: true, 43 Description: "The region of the S3 bucket.", 44 DefaultFunc: schema.EnvDefaultFunc("AWS_DEFAULT_REGION", nil), 45 }, 46 47 "endpoint": { 48 Type: schema.TypeString, 49 Optional: true, 50 Description: "A custom endpoint for the S3 API", 51 DefaultFunc: schema.EnvDefaultFunc("AWS_S3_ENDPOINT", ""), 52 }, 53 54 "encrypt": { 55 Type: schema.TypeBool, 56 Optional: true, 57 Description: "Whether to enable server side encryption of the state file", 58 Default: false, 59 }, 60 61 "acl": { 62 Type: schema.TypeString, 63 Optional: true, 64 Description: "Canned ACL to be applied to the state file", 65 Default: "", 66 }, 67 68 "access_key": { 69 Type: schema.TypeString, 70 Optional: true, 71 Description: "AWS access key", 72 Default: "", 73 }, 74 75 "secret_key": { 76 Type: schema.TypeString, 77 Optional: true, 78 Description: "AWS secret key", 79 Default: "", 80 }, 81 82 "kms_key_id": { 83 Type: schema.TypeString, 84 Optional: true, 85 Description: "The ARN of a KMS Key to use for encrypting the state", 86 Default: "", 87 }, 88 89 "lock_table": { 90 Type: schema.TypeString, 91 Optional: true, 92 Description: "DynamoDB table for state locking", 93 Default: "", 94 Deprecated: "please use the dynamodb_table attribute", 95 }, 96 97 "dynamodb_table": { 98 Type: schema.TypeString, 99 Optional: true, 100 Description: "DynamoDB table for state locking and consistency", 101 Default: "", 102 }, 103 104 "profile": { 105 Type: schema.TypeString, 106 Optional: true, 107 Description: "AWS profile name", 108 Default: "", 109 }, 110 111 "shared_credentials_file": { 112 Type: schema.TypeString, 113 Optional: true, 114 Description: "Path to a shared credentials file", 115 Default: "", 116 }, 117 118 "token": { 119 Type: schema.TypeString, 120 Optional: true, 121 Description: "MFA token", 122 Default: "", 123 }, 124 125 "skip_credentials_validation": { 126 Type: schema.TypeBool, 127 Optional: true, 128 Description: "Skip the credentials validation via STS API.", 129 Default: false, 130 }, 131 132 "skip_get_ec2_platforms": { 133 Type: schema.TypeBool, 134 Optional: true, 135 Description: "Skip getting the supported EC2 platforms.", 136 Default: false, 137 }, 138 139 "skip_region_validation": { 140 Type: schema.TypeBool, 141 Optional: true, 142 Description: "Skip static validation of region name.", 143 Default: false, 144 }, 145 146 "skip_requesting_account_id": { 147 Type: schema.TypeBool, 148 Optional: true, 149 Description: "Skip requesting the account ID.", 150 Default: false, 151 }, 152 153 "skip_metadata_api_check": { 154 Type: schema.TypeBool, 155 Optional: true, 156 Description: "Skip the AWS Metadata API check.", 157 Default: false, 158 }, 159 160 "role_arn": { 161 Type: schema.TypeString, 162 Optional: true, 163 Description: "The role to be assumed", 164 Default: "", 165 }, 166 167 "session_name": { 168 Type: schema.TypeString, 169 Optional: true, 170 Description: "The session name to use when assuming the role.", 171 Default: "", 172 }, 173 174 "external_id": { 175 Type: schema.TypeString, 176 Optional: true, 177 Description: "The external ID to use when assuming the role", 178 Default: "", 179 }, 180 181 "assume_role_policy": { 182 Type: schema.TypeString, 183 Optional: true, 184 Description: "The permissions applied when assuming a role.", 185 Default: "", 186 }, 187 188 "workspace_key_prefix": { 189 Type: schema.TypeString, 190 Optional: true, 191 Description: "The prefix applied to the non-default state path inside the bucket", 192 Default: "env:", 193 }, 194 195 "force_path_style": { 196 Type: schema.TypeBool, 197 Optional: true, 198 Description: "Force s3 to use path style api.", 199 Default: false, 200 }, 201 }, 202 } 203 204 result := &Backend{Backend: s} 205 result.Backend.ConfigureFunc = result.configure 206 return result 207 } 208 209 type Backend struct { 210 *schema.Backend 211 212 // The fields below are set from configure 213 s3Client *s3.S3 214 dynClient *dynamodb.DynamoDB 215 216 bucketName string 217 keyName string 218 serverSideEncryption bool 219 acl string 220 kmsKeyID string 221 ddbTable string 222 workspaceKeyPrefix string 223 } 224 225 func (b *Backend) configure(ctx context.Context) error { 226 if b.s3Client != nil { 227 return nil 228 } 229 230 // Grab the resource data 231 data := schema.FromContextBackendConfig(ctx) 232 233 b.bucketName = data.Get("bucket").(string) 234 b.keyName = data.Get("key").(string) 235 b.serverSideEncryption = data.Get("encrypt").(bool) 236 b.acl = data.Get("acl").(string) 237 b.kmsKeyID = data.Get("kms_key_id").(string) 238 b.workspaceKeyPrefix = data.Get("workspace_key_prefix").(string) 239 240 b.ddbTable = data.Get("dynamodb_table").(string) 241 if b.ddbTable == "" { 242 // try the deprecated field 243 b.ddbTable = data.Get("lock_table").(string) 244 } 245 246 cfg := &terraformAWS.Config{ 247 AccessKey: data.Get("access_key").(string), 248 AssumeRoleARN: data.Get("role_arn").(string), 249 AssumeRoleExternalID: data.Get("external_id").(string), 250 AssumeRolePolicy: data.Get("assume_role_policy").(string), 251 AssumeRoleSessionName: data.Get("session_name").(string), 252 CredsFilename: data.Get("shared_credentials_file").(string), 253 Profile: data.Get("profile").(string), 254 Region: data.Get("region").(string), 255 S3Endpoint: data.Get("endpoint").(string), 256 SecretKey: data.Get("secret_key").(string), 257 Token: data.Get("token").(string), 258 SkipCredsValidation: data.Get("skip_credentials_validation").(bool), 259 SkipGetEC2Platforms: data.Get("skip_get_ec2_platforms").(bool), 260 SkipRegionValidation: data.Get("skip_region_validation").(bool), 261 SkipRequestingAccountId: data.Get("skip_requesting_account_id").(bool), 262 SkipMetadataApiCheck: data.Get("skip_metadata_api_check").(bool), 263 S3ForcePathStyle: data.Get("force_path_style").(bool), 264 } 265 266 client, err := cfg.Client() 267 if err != nil { 268 return err 269 } 270 271 b.s3Client = client.(*terraformAWS.AWSClient).S3() 272 b.dynClient = client.(*terraformAWS.AWSClient).DynamoDB() 273 274 return nil 275 }