cloud9

package
v5.0.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Mar 21, 2022 License: Apache-2.0 Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type EnvironmentEC2 

type EnvironmentEC2 struct {
	pulumi.CustomResourceState

	// The ARN of the environment.
	Arn pulumi.StringOutput `pulumi:"arn"`
	// The number of minutes until the running instance is shut down after the environment has last been used.
	AutomaticStopTimeMinutes pulumi.IntPtrOutput `pulumi:"automaticStopTimeMinutes"`
	// The description of the environment.
	Description pulumi.StringPtrOutput `pulumi:"description"`
	// The type of instance to connect to the environment, e.g., `t2.micro`.
	InstanceType pulumi.StringOutput `pulumi:"instanceType"`
	// The name of the environment.
	Name pulumi.StringOutput `pulumi:"name"`
	// The ARN of the environment owner. This can be ARN of any AWS IAM principal. Defaults to the environment's creator.
	OwnerArn pulumi.StringOutput `pulumi:"ownerArn"`
	// The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.
	SubnetId pulumi.StringPtrOutput `pulumi:"subnetId"`
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapOutput `pulumi:"tags"`
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapOutput `pulumi:"tagsAll"`
	// The type of the environment (e.g., `ssh` or `ec2`)
	Type pulumi.StringOutput `pulumi:"type"`
}

Provides a Cloud9 EC2 Development Environment.

## Example Usage

Basic usage:

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloud9"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloud9.NewEnvironmentEC2(ctx, "example", &cloud9.EnvironmentEC2Args{
			InstanceType: pulumi.String("t2.micro"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

Get the URL of the Cloud9 environment after creation:

```go package main

import ( 

"fmt"

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := cloud9.NewEnvironmentEC2(ctx, "example", &cloud9.EnvironmentEC2Args{
			InstanceType: pulumi.String("t2.micro"),
		})
		if err != nil {
			return err
		}
		_ = ec2.LookupInstanceOutput(ctx, ec2.GetInstanceOutputArgs{
			Filters: ec2.GetInstanceFilterArray{
				&ec2.GetInstanceFilterArgs{
					Name: pulumi.String("tag:aws:cloud9:environment"),
					Values: pulumi.StringArray{
						example.ID(),
					},
				},
			},
		}, nil)
		ctx.Export("cloud9Url", example.ID().ApplyT(func(id string) (string, error) {
			return fmt.Sprintf("%v%v%v%v", "https://", _var.Region, ".console.aws.amazon.com/cloud9/ide/", id), nil
		}).(pulumi.StringOutput))
		return nil
	})
}

```

Allocate a static IP to the Cloud9 environment:

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/ec2"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := cloud9.NewEnvironmentEC2(ctx, "example", &cloud9.EnvironmentEC2Args{
			InstanceType: pulumi.String("t2.micro"),
		})
		if err != nil {
			return err
		}
		cloud9Instance := ec2.LookupInstanceOutput(ctx, ec2.GetInstanceOutputArgs{
			Filters: ec2.GetInstanceFilterArray{
				&ec2.GetInstanceFilterArgs{
					Name: pulumi.String("tag:aws:cloud9:environment"),
					Values: pulumi.StringArray{
						example.ID(),
					},
				},
			},
		}, nil)
		cloud9Eip, err := ec2.NewEip(ctx, "cloud9Eip", &ec2.EipArgs{
			Instance: cloud9Instance.ApplyT(func(cloud9Instance ec2.GetInstanceResult) (string, error) {
				return cloud9Instance.Id, nil
			}).(pulumi.StringOutput),
			Vpc: pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		ctx.Export("cloud9PublicIp", cloud9Eip.PublicIp)
		return nil
	})
}

```

func GetEnvironmentEC2 

func GetEnvironmentEC2(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *EnvironmentEC2State, opts ...pulumi.ResourceOption) (*EnvironmentEC2, error)

GetEnvironmentEC2 gets an existing EnvironmentEC2 resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewEnvironmentEC2 

func NewEnvironmentEC2(ctx *pulumi.Context,
	name string, args *EnvironmentEC2Args, opts ...pulumi.ResourceOption) (*EnvironmentEC2, error)

NewEnvironmentEC2 registers a new resource with the given unique name, arguments, and options.

func (*EnvironmentEC2) ElementType 

func (*EnvironmentEC2) ElementType() reflect.Type

func (*EnvironmentEC2) ToEnvironmentEC2Output 

func (i *EnvironmentEC2) ToEnvironmentEC2Output() EnvironmentEC2Output

func (*EnvironmentEC2) ToEnvironmentEC2OutputWithContext 

func (i *EnvironmentEC2) ToEnvironmentEC2OutputWithContext(ctx context.Context) EnvironmentEC2Output

type EnvironmentEC2Args 

type EnvironmentEC2Args struct {
	// The number of minutes until the running instance is shut down after the environment has last been used.
	AutomaticStopTimeMinutes pulumi.IntPtrInput
	// The description of the environment.
	Description pulumi.StringPtrInput
	// The type of instance to connect to the environment, e.g., `t2.micro`.
	InstanceType pulumi.StringInput
	// The name of the environment.
	Name pulumi.StringPtrInput
	// The ARN of the environment owner. This can be ARN of any AWS IAM principal. Defaults to the environment's creator.
	OwnerArn pulumi.StringPtrInput
	// The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.
	SubnetId pulumi.StringPtrInput
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
}

The set of arguments for constructing a EnvironmentEC2 resource.

func (EnvironmentEC2Args) ElementType 

func (EnvironmentEC2Args) ElementType() reflect.Type

type EnvironmentEC2Array 

type EnvironmentEC2Array []EnvironmentEC2Input

func (EnvironmentEC2Array) ElementType 

func (EnvironmentEC2Array) ElementType() reflect.Type

func (EnvironmentEC2Array) ToEnvironmentEC2ArrayOutput 

func (i EnvironmentEC2Array) ToEnvironmentEC2ArrayOutput() EnvironmentEC2ArrayOutput

func (EnvironmentEC2Array) ToEnvironmentEC2ArrayOutputWithContext 

func (i EnvironmentEC2Array) ToEnvironmentEC2ArrayOutputWithContext(ctx context.Context) EnvironmentEC2ArrayOutput

type EnvironmentEC2ArrayInput 

type EnvironmentEC2ArrayInput interface {
	pulumi.Input

	ToEnvironmentEC2ArrayOutput() EnvironmentEC2ArrayOutput
	ToEnvironmentEC2ArrayOutputWithContext(context.Context) EnvironmentEC2ArrayOutput
}

EnvironmentEC2ArrayInput is an input type that accepts EnvironmentEC2Array and EnvironmentEC2ArrayOutput values. You can construct a concrete instance of `EnvironmentEC2ArrayInput` via: 

EnvironmentEC2Array{ EnvironmentEC2Args{...} }

type EnvironmentEC2ArrayOutput 

type EnvironmentEC2ArrayOutput struct{ *pulumi.OutputState }

func (EnvironmentEC2ArrayOutput) ElementType 

func (EnvironmentEC2ArrayOutput) ElementType() reflect.Type

func (EnvironmentEC2ArrayOutput) Index 

func (o EnvironmentEC2ArrayOutput) Index(i pulumi.IntInput) EnvironmentEC2Output

func (EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutput 

func (o EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutput() EnvironmentEC2ArrayOutput

func (EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutputWithContext 

func (o EnvironmentEC2ArrayOutput) ToEnvironmentEC2ArrayOutputWithContext(ctx context.Context) EnvironmentEC2ArrayOutput

type EnvironmentEC2Input 

type EnvironmentEC2Input interface {
	pulumi.Input

	ToEnvironmentEC2Output() EnvironmentEC2Output
	ToEnvironmentEC2OutputWithContext(ctx context.Context) EnvironmentEC2Output
}

type EnvironmentEC2Map 

type EnvironmentEC2Map map[string]EnvironmentEC2Input

func (EnvironmentEC2Map) ElementType 

func (EnvironmentEC2Map) ElementType() reflect.Type

func (EnvironmentEC2Map) ToEnvironmentEC2MapOutput 

func (i EnvironmentEC2Map) ToEnvironmentEC2MapOutput() EnvironmentEC2MapOutput

func (EnvironmentEC2Map) ToEnvironmentEC2MapOutputWithContext 

func (i EnvironmentEC2Map) ToEnvironmentEC2MapOutputWithContext(ctx context.Context) EnvironmentEC2MapOutput

type EnvironmentEC2MapInput 

type EnvironmentEC2MapInput interface {
	pulumi.Input

	ToEnvironmentEC2MapOutput() EnvironmentEC2MapOutput
	ToEnvironmentEC2MapOutputWithContext(context.Context) EnvironmentEC2MapOutput
}

EnvironmentEC2MapInput is an input type that accepts EnvironmentEC2Map and EnvironmentEC2MapOutput values. You can construct a concrete instance of `EnvironmentEC2MapInput` via: 

EnvironmentEC2Map{ "key": EnvironmentEC2Args{...} }

type EnvironmentEC2MapOutput 

type EnvironmentEC2MapOutput struct{ *pulumi.OutputState }

func (EnvironmentEC2MapOutput) ElementType 

func (EnvironmentEC2MapOutput) ElementType() reflect.Type

func (EnvironmentEC2MapOutput) MapIndex 

func (o EnvironmentEC2MapOutput) MapIndex(k pulumi.StringInput) EnvironmentEC2Output

func (EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutput 

func (o EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutput() EnvironmentEC2MapOutput

func (EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutputWithContext 

func (o EnvironmentEC2MapOutput) ToEnvironmentEC2MapOutputWithContext(ctx context.Context) EnvironmentEC2MapOutput

type EnvironmentEC2Output 

type EnvironmentEC2Output struct{ *pulumi.OutputState }

func (EnvironmentEC2Output) ElementType 

func (EnvironmentEC2Output) ElementType() reflect.Type

func (EnvironmentEC2Output) ToEnvironmentEC2Output 

func (o EnvironmentEC2Output) ToEnvironmentEC2Output() EnvironmentEC2Output

func (EnvironmentEC2Output) ToEnvironmentEC2OutputWithContext 

func (o EnvironmentEC2Output) ToEnvironmentEC2OutputWithContext(ctx context.Context) EnvironmentEC2Output

type EnvironmentEC2State 

type EnvironmentEC2State struct {
	// The ARN of the environment.
	Arn pulumi.StringPtrInput
	// The number of minutes until the running instance is shut down after the environment has last been used.
	AutomaticStopTimeMinutes pulumi.IntPtrInput
	// The description of the environment.
	Description pulumi.StringPtrInput
	// The type of instance to connect to the environment, e.g., `t2.micro`.
	InstanceType pulumi.StringPtrInput
	// The name of the environment.
	Name pulumi.StringPtrInput
	// The ARN of the environment owner. This can be ARN of any AWS IAM principal. Defaults to the environment's creator.
	OwnerArn pulumi.StringPtrInput
	// The ID of the subnet in Amazon VPC that AWS Cloud9 will use to communicate with the Amazon EC2 instance.
	SubnetId pulumi.StringPtrInput
	// Key-value map of resource tags. .If configured with a provider `defaultTags` configuration block present, tags with matching keys will overwrite those defined at the provider-level.
	Tags pulumi.StringMapInput
	// A map of tags assigned to the resource, including those inherited from the provider `defaultTags` configuration block.
	TagsAll pulumi.StringMapInput
	// The type of the environment (e.g., `ssh` or `ec2`)
	Type pulumi.StringPtrInput
}

func (EnvironmentEC2State) ElementType 

func (EnvironmentEC2State) ElementType() reflect.Type

type EnvironmentMembership 

type EnvironmentMembership struct {
	pulumi.CustomResourceState

	// The ID of the environment that contains the environment member you want to add.
	EnvironmentId pulumi.StringOutput `pulumi:"environmentId"`
	// The type of environment member permissions you want to associate with this environment member. Allowed values are `read-only` and `read-write` .
	Permissions pulumi.StringOutput `pulumi:"permissions"`
	// The Amazon Resource Name (ARN) of the environment member you want to add.
	UserArn pulumi.StringOutput `pulumi:"userArn"`
	// he user ID in AWS Identity and Access Management (AWS IAM) of the environment member.
	UserId pulumi.StringOutput `pulumi:"userId"`
}

Provides an environment member to an AWS Cloud9 development environment.

## Example Usage

```go package main

import ( 

"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/cloud9"
"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/iam"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"

) 

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		testEnvironmentEC2, err := cloud9.NewEnvironmentEC2(ctx, "testEnvironmentEC2", &cloud9.EnvironmentEC2Args{
			InstanceType: pulumi.String("t2.micro"),
		})
		if err != nil {
			return err
		}
		testUser, err := iam.NewUser(ctx, "testUser", nil)
		if err != nil {
			return err
		}
		_, err = cloud9.NewEnvironmentMembership(ctx, "testEnvironmentMembership", &cloud9.EnvironmentMembershipArgs{
			EnvironmentId: testEnvironmentEC2.ID(),
			Permissions:   pulumi.String("read-only"),
			UserArn:       testUser.Arn,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

```

## Import

Cloud9 environment membership can be imported using the `environment-id#user-arn`, e.g.

```sh 

$ pulumi import aws:cloud9/environmentMembership:EnvironmentMembership test environment-id#user-arn

```

func GetEnvironmentMembership 

func GetEnvironmentMembership(ctx *pulumi.Context,
	name string, id pulumi.IDInput, state *EnvironmentMembershipState, opts ...pulumi.ResourceOption) (*EnvironmentMembership, error)

GetEnvironmentMembership gets an existing EnvironmentMembership resource's state with the given name, ID, and optional state properties that are used to uniquely qualify the lookup (nil if not required).

func NewEnvironmentMembership 

func NewEnvironmentMembership(ctx *pulumi.Context,
	name string, args *EnvironmentMembershipArgs, opts ...pulumi.ResourceOption) (*EnvironmentMembership, error)

NewEnvironmentMembership registers a new resource with the given unique name, arguments, and options.

func (*EnvironmentMembership) ElementType 

func (*EnvironmentMembership) ElementType() reflect.Type

func (*EnvironmentMembership) ToEnvironmentMembershipOutput 

func (i *EnvironmentMembership) ToEnvironmentMembershipOutput() EnvironmentMembershipOutput

func (*EnvironmentMembership) ToEnvironmentMembershipOutputWithContext 

func (i *EnvironmentMembership) ToEnvironmentMembershipOutputWithContext(ctx context.Context) EnvironmentMembershipOutput

type EnvironmentMembershipArgs 

type EnvironmentMembershipArgs struct {
	// The ID of the environment that contains the environment member you want to add.
	EnvironmentId pulumi.StringInput
	// The type of environment member permissions you want to associate with this environment member. Allowed values are `read-only` and `read-write` .
	Permissions pulumi.StringInput
	// The Amazon Resource Name (ARN) of the environment member you want to add.
	UserArn pulumi.StringInput
}

The set of arguments for constructing a EnvironmentMembership resource.

func (EnvironmentMembershipArgs) ElementType 

func (EnvironmentMembershipArgs) ElementType() reflect.Type

type EnvironmentMembershipArray 

type EnvironmentMembershipArray []EnvironmentMembershipInput

func (EnvironmentMembershipArray) ElementType 

func (EnvironmentMembershipArray) ElementType() reflect.Type

func (EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutput 

func (i EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutput() EnvironmentMembershipArrayOutput

func (EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutputWithContext 

func (i EnvironmentMembershipArray) ToEnvironmentMembershipArrayOutputWithContext(ctx context.Context) EnvironmentMembershipArrayOutput

type EnvironmentMembershipArrayInput 

type EnvironmentMembershipArrayInput interface {
	pulumi.Input

	ToEnvironmentMembershipArrayOutput() EnvironmentMembershipArrayOutput
	ToEnvironmentMembershipArrayOutputWithContext(context.Context) EnvironmentMembershipArrayOutput
}

EnvironmentMembershipArrayInput is an input type that accepts EnvironmentMembershipArray and EnvironmentMembershipArrayOutput values. You can construct a concrete instance of `EnvironmentMembershipArrayInput` via: 

EnvironmentMembershipArray{ EnvironmentMembershipArgs{...} }

type EnvironmentMembershipArrayOutput 

type EnvironmentMembershipArrayOutput struct{ *pulumi.OutputState }

func (EnvironmentMembershipArrayOutput) ElementType 

func (EnvironmentMembershipArrayOutput) ElementType() reflect.Type

func (EnvironmentMembershipArrayOutput) Index 

func (o EnvironmentMembershipArrayOutput) Index(i pulumi.IntInput) EnvironmentMembershipOutput

func (EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutput 

func (o EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutput() EnvironmentMembershipArrayOutput

func (EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutputWithContext 

func (o EnvironmentMembershipArrayOutput) ToEnvironmentMembershipArrayOutputWithContext(ctx context.Context) EnvironmentMembershipArrayOutput

type EnvironmentMembershipInput 

type EnvironmentMembershipInput interface {
	pulumi.Input

	ToEnvironmentMembershipOutput() EnvironmentMembershipOutput
	ToEnvironmentMembershipOutputWithContext(ctx context.Context) EnvironmentMembershipOutput
}

type EnvironmentMembershipMap 

type EnvironmentMembershipMap map[string]EnvironmentMembershipInput

func (EnvironmentMembershipMap) ElementType 

func (EnvironmentMembershipMap) ElementType() reflect.Type

func (EnvironmentMembershipMap) ToEnvironmentMembershipMapOutput 

func (i EnvironmentMembershipMap) ToEnvironmentMembershipMapOutput() EnvironmentMembershipMapOutput

func (EnvironmentMembershipMap) ToEnvironmentMembershipMapOutputWithContext 

func (i EnvironmentMembershipMap) ToEnvironmentMembershipMapOutputWithContext(ctx context.Context) EnvironmentMembershipMapOutput

type EnvironmentMembershipMapInput 

type EnvironmentMembershipMapInput interface {
	pulumi.Input

	ToEnvironmentMembershipMapOutput() EnvironmentMembershipMapOutput
	ToEnvironmentMembershipMapOutputWithContext(context.Context) EnvironmentMembershipMapOutput
}

EnvironmentMembershipMapInput is an input type that accepts EnvironmentMembershipMap and EnvironmentMembershipMapOutput values. You can construct a concrete instance of `EnvironmentMembershipMapInput` via: 

EnvironmentMembershipMap{ "key": EnvironmentMembershipArgs{...} }

type EnvironmentMembershipMapOutput 

type EnvironmentMembershipMapOutput struct{ *pulumi.OutputState }

func (EnvironmentMembershipMapOutput) ElementType 

func (EnvironmentMembershipMapOutput) ElementType() reflect.Type

func (EnvironmentMembershipMapOutput) MapIndex 

func (o EnvironmentMembershipMapOutput) MapIndex(k pulumi.StringInput) EnvironmentMembershipOutput

func (EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutput 

func (o EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutput() EnvironmentMembershipMapOutput

func (EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutputWithContext 

func (o EnvironmentMembershipMapOutput) ToEnvironmentMembershipMapOutputWithContext(ctx context.Context) EnvironmentMembershipMapOutput

type EnvironmentMembershipOutput 

type EnvironmentMembershipOutput struct{ *pulumi.OutputState }

func (EnvironmentMembershipOutput) ElementType 

func (EnvironmentMembershipOutput) ElementType() reflect.Type

func (EnvironmentMembershipOutput) ToEnvironmentMembershipOutput 

func (o EnvironmentMembershipOutput) ToEnvironmentMembershipOutput() EnvironmentMembershipOutput

func (EnvironmentMembershipOutput) ToEnvironmentMembershipOutputWithContext 

func (o EnvironmentMembershipOutput) ToEnvironmentMembershipOutputWithContext(ctx context.Context) EnvironmentMembershipOutput

type EnvironmentMembershipState 

type EnvironmentMembershipState struct {
	// The ID of the environment that contains the environment member you want to add.
	EnvironmentId pulumi.StringPtrInput
	// The type of environment member permissions you want to associate with this environment member. Allowed values are `read-only` and `read-write` .
	Permissions pulumi.StringPtrInput
	// The Amazon Resource Name (ARN) of the environment member you want to add.
	UserArn pulumi.StringPtrInput
	// he user ID in AWS Identity and Access Management (AWS IAM) of the environment member.
	UserId pulumi.StringPtrInput
}

func (EnvironmentMembershipState) ElementType 

func (EnvironmentMembershipState) ElementType() reflect.Type

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.