pulumi/sdk/go
Aaron Friel 091d953bb4 Adds `pulumi package new`
This command adds a new plugin type, Boilerplate, which takes a name and config
(of unspecified format) and is expected to generate a new Pulumi package, i.e.:
a provider.

A working implementation of the Boilerplate provider is implemented in
pulumi/ci-mgmt#457. Using this command with the following configuration, a user
can generate a working Pulumi provider binary in a single command. As the
boilerplate is implemented as a plugin, it can be updated independently of the
Pulumi CLI, versioned, and programmatically shim bridged providers.

```yaml
module: github.com/pulumi/pulumi-porkbun
providerTitle: "Porkbun"
publisher: "Pulumi"
homepage: "https://www.pulumi.com/"
logoURL: ""
major-version: 0

upstreamOrg: cullenmcdermott
upstreamRepo: terraform-provider-porkbun

sdks:
  nodejs: "@pulumi/porkbun"
  python: pulumi_porkbun
  dotnet: Pulumi.Porkbun
  # Include the major version here, i.e.: sdk/v4 or just sdk for v0 and v1
  go: github.com/pulumi/pulumi-porkbun/sdk
```
2023-11-12 17:55:01 -08:00
..
auto Allow shallow clones for local workspaces (#14312) 2023-11-01 17:21:52 +00:00
common Adds `pulumi package new` 2023-11-12 17:55:01 -08:00
internal sdk/go: Add pulumix subpackage (#13509) 2023-08-28 15:38:23 +00:00
pulumi pass through property values to RunRequest (#14273) 2023-10-20 10:44:16 +00:00
pulumi-language-go Changelog and go.mod updates for v3.92.0 (#14496) 2023-11-03 16:42:03 +00:00
pulumix Rename Output.Join to Flatten (#13882) 2023-09-06 15:05:24 +00:00
Makefile make(sdk/go): Use -C instead of cd for 'go' commands (#13853) 2023-08-31 21:12:03 +00:00
README.md `pulumi update` => `pulumi up` (#2702) 2019-05-06 14:00:18 -07:00

README.md

Pulumi Golang SDK

This directory contains support for writing Pulumi programs in the Go language. There are two aspects to this:

  • pulumi/ contains the client language bindings Pulumi program's code directly against;
  • pulumi-language-go/ contains the language host plugin that the Pulumi engine uses to orchestrate updates.

To author a Pulumi program in Go, simply say so in your Pulumi.yaml

name: <my-project>
runtime: go

and ensure you have pulumi-language-go on your path (it is distributed in the Pulumi download automatically).

By default, the language plugin will use your project's name, <my-project>, as the executable that it loads. This too must be on your path for the language provider to load it when you run pulumi preview or pulumi up.