History

Martin Lehmann cca17f814a chore(sdk/go): fix a somewhat misleading comment		2023-02-21 11:41:08 +01:00
..
auto	all(go.mod): Upgrade golang.org/x/net to v0.7.0	2023-02-17 11:06:15 -08:00
common	chore(sdk/go): fix a somewhat misleading comment	2023-02-21 11:41:08 +01:00
pulumi	chore(sdk/go): Use subtests in TestResourceOptionMergingProvider	2023-02-16 12:54:35 -08:00
pulumi-language-go	Clean up pkg/errors in go language host	2023-01-14 20:56:53 +00:00
Makefile	ci: Enable testing of language version sets	2022-09-21 09:48:38 -07: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.