26c144c916
This brings over the initial buildx prototype from pulumi/pulumi-docker and fixes various build and release issues.
308 lines
9.1 KiB
Go
308 lines
9.1 KiB
Go
// Code generated by pulumi-language-go DO NOT EDIT.
|
|
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***
|
|
|
|
package dockerbuild
|
|
|
|
import (
|
|
"context"
|
|
"reflect"
|
|
|
|
"errors"
|
|
"github.com/pulumi/pulumi-docker-build/sdk/go/dockerbuild/internal"
|
|
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
|
|
"github.com/pulumi/pulumi/sdk/v3/go/pulumix"
|
|
)
|
|
|
|
// A wrapper around `docker buildx imagetools create` to create an index
|
|
// (or manifest list) referencing one or more existing images.
|
|
//
|
|
// In most cases you do not need an `Index` to build a multi-platform
|
|
// image -- specifying multiple platforms on the `Image` will handle this
|
|
// for you automatically.
|
|
//
|
|
// However, as of April 2024, building multi-platform images _with
|
|
// caching_ will only export a cache for one platform at a time (see [this
|
|
// discussion](https://github.com/docker/buildx/discussions/1382) for more
|
|
// details).
|
|
//
|
|
// Therefore this resource can be helpful if you are building
|
|
// multi-platform images with caching: each platform can be built and
|
|
// cached separately, and an `Index` can join them all together. An
|
|
// example of this is shown below.
|
|
//
|
|
// This resource creates an OCI image index or a Docker manifest list
|
|
// depending on the media types of the source images.
|
|
//
|
|
// ## Example Usage
|
|
// ### Multi-platform registry caching
|
|
// ```go
|
|
// package main
|
|
//
|
|
// import (
|
|
//
|
|
// "github.com/pulumi/pulumi-docker-build/sdk/go/dockerbuild"
|
|
// "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
|
|
//
|
|
// )
|
|
//
|
|
// func main() {
|
|
// pulumi.Run(func(ctx *pulumi.Context) error {
|
|
// amd64, err := dockerbuild.NewImage(ctx, "amd64", &dockerbuild.ImageArgs{
|
|
// CacheFrom: dockerbuild.CacheFromArray{
|
|
// &dockerbuild.CacheFromArgs{
|
|
// Registry: &dockerbuild.CacheFromRegistryArgs{
|
|
// Ref: pulumi.String("docker.io/pulumi/pulumi:cache-amd64"),
|
|
// },
|
|
// },
|
|
// },
|
|
// CacheTo: dockerbuild.CacheToArray{
|
|
// &dockerbuild.CacheToArgs{
|
|
// Registry: &dockerbuild.CacheToRegistryArgs{
|
|
// Mode: dockerbuild.CacheModeMax,
|
|
// Ref: pulumi.String("docker.io/pulumi/pulumi:cache-amd64"),
|
|
// },
|
|
// },
|
|
// },
|
|
// Context: &dockerbuild.BuildContextArgs{
|
|
// Location: pulumi.String("app"),
|
|
// },
|
|
// Platforms: docker - build.PlatformArray{
|
|
// dockerbuild.Platform_Linux_amd64,
|
|
// },
|
|
// Tags: pulumi.StringArray{
|
|
// pulumi.String("docker.io/pulumi/pulumi:3.107.0-amd64"),
|
|
// },
|
|
// })
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
// arm64, err := dockerbuild.NewImage(ctx, "arm64", &dockerbuild.ImageArgs{
|
|
// CacheFrom: dockerbuild.CacheFromArray{
|
|
// &dockerbuild.CacheFromArgs{
|
|
// Registry: &dockerbuild.CacheFromRegistryArgs{
|
|
// Ref: pulumi.String("docker.io/pulumi/pulumi:cache-arm64"),
|
|
// },
|
|
// },
|
|
// },
|
|
// CacheTo: dockerbuild.CacheToArray{
|
|
// &dockerbuild.CacheToArgs{
|
|
// Registry: &dockerbuild.CacheToRegistryArgs{
|
|
// Mode: dockerbuild.CacheModeMax,
|
|
// Ref: pulumi.String("docker.io/pulumi/pulumi:cache-arm64"),
|
|
// },
|
|
// },
|
|
// },
|
|
// Context: &dockerbuild.BuildContextArgs{
|
|
// Location: pulumi.String("app"),
|
|
// },
|
|
// Platforms: docker - build.PlatformArray{
|
|
// dockerbuild.Platform_Linux_arm64,
|
|
// },
|
|
// Tags: pulumi.StringArray{
|
|
// pulumi.String("docker.io/pulumi/pulumi:3.107.0-arm64"),
|
|
// },
|
|
// })
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
// index, err := dockerbuild.NewIndex(ctx, "index", &dockerbuild.IndexArgs{
|
|
// Sources: pulumi.StringArray{
|
|
// amd64.Ref,
|
|
// arm64.Ref,
|
|
// },
|
|
// Tag: pulumi.String("docker.io/pulumi/pulumi:3.107.0"),
|
|
// })
|
|
// if err != nil {
|
|
// return err
|
|
// }
|
|
// ctx.Export("ref", index.Ref)
|
|
// return nil
|
|
// })
|
|
// }
|
|
//
|
|
// ```
|
|
type Index struct {
|
|
pulumi.CustomResourceState
|
|
|
|
// If true, push the index to the target registry.
|
|
//
|
|
// Defaults to `true`.
|
|
Push pulumi.BoolPtrOutput `pulumi:"push"`
|
|
// The pushed tag with digest.
|
|
//
|
|
// Identical to the tag if the index was not pushed.
|
|
Ref pulumi.StringOutput `pulumi:"ref"`
|
|
// Authentication for the registry where the tagged index will be pushed.
|
|
//
|
|
// Credentials can also be included with the provider's configuration.
|
|
Registry RegistryPtrOutput `pulumi:"registry"`
|
|
// Existing images to include in the index.
|
|
Sources pulumi.StringArrayOutput `pulumi:"sources"`
|
|
// The tag to apply to the index.
|
|
Tag pulumi.StringOutput `pulumi:"tag"`
|
|
}
|
|
|
|
// NewIndex registers a new resource with the given unique name, arguments, and options.
|
|
func NewIndex(ctx *pulumi.Context,
|
|
name string, args *IndexArgs, opts ...pulumi.ResourceOption) (*Index, error) {
|
|
if args == nil {
|
|
return nil, errors.New("missing one or more required arguments")
|
|
}
|
|
|
|
if args.Sources == nil {
|
|
return nil, errors.New("invalid value for required argument 'Sources'")
|
|
}
|
|
if args.Tag == nil {
|
|
return nil, errors.New("invalid value for required argument 'Tag'")
|
|
}
|
|
if args.Push == nil {
|
|
args.Push = pulumi.BoolPtr(true)
|
|
}
|
|
opts = internal.PkgResourceDefaultOpts(opts)
|
|
var resource Index
|
|
err := ctx.RegisterResource("docker-build:index:Index", name, args, &resource, opts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &resource, nil
|
|
}
|
|
|
|
// GetIndex gets an existing Index 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 GetIndex(ctx *pulumi.Context,
|
|
name string, id pulumi.IDInput, state *IndexState, opts ...pulumi.ResourceOption) (*Index, error) {
|
|
var resource Index
|
|
err := ctx.ReadResource("docker-build:index:Index", name, id, state, &resource, opts...)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
return &resource, nil
|
|
}
|
|
|
|
// Input properties used for looking up and filtering Index resources.
|
|
type indexState struct {
|
|
}
|
|
|
|
type IndexState struct {
|
|
}
|
|
|
|
func (IndexState) ElementType() reflect.Type {
|
|
return reflect.TypeOf((*indexState)(nil)).Elem()
|
|
}
|
|
|
|
type indexArgs struct {
|
|
// If true, push the index to the target registry.
|
|
//
|
|
// Defaults to `true`.
|
|
Push *bool `pulumi:"push"`
|
|
// Authentication for the registry where the tagged index will be pushed.
|
|
//
|
|
// Credentials can also be included with the provider's configuration.
|
|
Registry *Registry `pulumi:"registry"`
|
|
// Existing images to include in the index.
|
|
Sources []string `pulumi:"sources"`
|
|
// The tag to apply to the index.
|
|
Tag string `pulumi:"tag"`
|
|
}
|
|
|
|
// The set of arguments for constructing a Index resource.
|
|
type IndexArgs struct {
|
|
// If true, push the index to the target registry.
|
|
//
|
|
// Defaults to `true`.
|
|
Push pulumi.BoolPtrInput
|
|
// Authentication for the registry where the tagged index will be pushed.
|
|
//
|
|
// Credentials can also be included with the provider's configuration.
|
|
Registry RegistryPtrInput
|
|
// Existing images to include in the index.
|
|
Sources pulumi.StringArrayInput
|
|
// The tag to apply to the index.
|
|
Tag pulumi.StringInput
|
|
}
|
|
|
|
func (IndexArgs) ElementType() reflect.Type {
|
|
return reflect.TypeOf((*indexArgs)(nil)).Elem()
|
|
}
|
|
|
|
type IndexInput interface {
|
|
pulumi.Input
|
|
|
|
ToIndexOutput() IndexOutput
|
|
ToIndexOutputWithContext(ctx context.Context) IndexOutput
|
|
}
|
|
|
|
func (*Index) ElementType() reflect.Type {
|
|
return reflect.TypeOf((**Index)(nil)).Elem()
|
|
}
|
|
|
|
func (i *Index) ToIndexOutput() IndexOutput {
|
|
return i.ToIndexOutputWithContext(context.Background())
|
|
}
|
|
|
|
func (i *Index) ToIndexOutputWithContext(ctx context.Context) IndexOutput {
|
|
return pulumi.ToOutputWithContext(ctx, i).(IndexOutput)
|
|
}
|
|
|
|
func (i *Index) ToOutput(ctx context.Context) pulumix.Output[*Index] {
|
|
return pulumix.Output[*Index]{
|
|
OutputState: i.ToIndexOutputWithContext(ctx).OutputState,
|
|
}
|
|
}
|
|
|
|
type IndexOutput struct{ *pulumi.OutputState }
|
|
|
|
func (IndexOutput) ElementType() reflect.Type {
|
|
return reflect.TypeOf((**Index)(nil)).Elem()
|
|
}
|
|
|
|
func (o IndexOutput) ToIndexOutput() IndexOutput {
|
|
return o
|
|
}
|
|
|
|
func (o IndexOutput) ToIndexOutputWithContext(ctx context.Context) IndexOutput {
|
|
return o
|
|
}
|
|
|
|
func (o IndexOutput) ToOutput(ctx context.Context) pulumix.Output[*Index] {
|
|
return pulumix.Output[*Index]{
|
|
OutputState: o.OutputState,
|
|
}
|
|
}
|
|
|
|
// If true, push the index to the target registry.
|
|
//
|
|
// Defaults to `true`.
|
|
func (o IndexOutput) Push() pulumi.BoolPtrOutput {
|
|
return o.ApplyT(func(v *Index) pulumi.BoolPtrOutput { return v.Push }).(pulumi.BoolPtrOutput)
|
|
}
|
|
|
|
// The pushed tag with digest.
|
|
//
|
|
// Identical to the tag if the index was not pushed.
|
|
func (o IndexOutput) Ref() pulumi.StringOutput {
|
|
return o.ApplyT(func(v *Index) pulumi.StringOutput { return v.Ref }).(pulumi.StringOutput)
|
|
}
|
|
|
|
// Authentication for the registry where the tagged index will be pushed.
|
|
//
|
|
// Credentials can also be included with the provider's configuration.
|
|
func (o IndexOutput) Registry() RegistryPtrOutput {
|
|
return o.ApplyT(func(v *Index) RegistryPtrOutput { return v.Registry }).(RegistryPtrOutput)
|
|
}
|
|
|
|
// Existing images to include in the index.
|
|
func (o IndexOutput) Sources() pulumi.StringArrayOutput {
|
|
return o.ApplyT(func(v *Index) pulumi.StringArrayOutput { return v.Sources }).(pulumi.StringArrayOutput)
|
|
}
|
|
|
|
// The tag to apply to the index.
|
|
func (o IndexOutput) Tag() pulumi.StringOutput {
|
|
return o.ApplyT(func(v *Index) pulumi.StringOutput { return v.Tag }).(pulumi.StringOutput)
|
|
}
|
|
|
|
func init() {
|
|
pulumi.RegisterInputType(reflect.TypeOf((*IndexInput)(nil)).Elem(), &Index{})
|
|
pulumi.RegisterOutputType(IndexOutput{})
|
|
}
|