History

Ian Wahbe 278055c101 Opt language hosts out of `PULUMI_IGNORE_AMBIENT_PLUGINS` (#8576 ) * PULUMI_IGNORE_AMBIENT_PLUGINS excepts lang-plugins * Update CHANGELOG_PENDING.md		2021-12-10 13:23:54 -08:00
..
auto	.NET & python SDKs parity for bad pulumi versions (#8297 )	2021-10-27 20:54:23 -07:00
common	Opt language hosts out of `PULUMI_IGNORE_AMBIENT_PLUGINS` (#8576 )	2021-12-10 13:23:54 -08:00
pulumi	Add tests that return failures from Call (#8424 )	2021-11-16 08:58:46 -08:00
pulumi-language-go	[codegen/go] Emit `pulumiplugin.json` as part of codegen (#8530 )	2021-12-06 13:10:30 -08:00
Makefile	[automation-api] Exclude tests from test_fast. (#7986 )	2021-09-16 17:33:33 -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.