History

Matt Ellis 7dfc3b630e Remove the need for /opt/pulumi This is an artifact of the past, where we did not ship packages via NPM but instead linked everything. At that time, we wanted to have our own install location for Pulumi, because it reflected how we shipped the product. This was pretty confusing, because we had both `build` and `install` targets, and we'd put some binaries both in `GOBIN` and `/opt/pulumi/bin` leading to general confusion. Now we simplify things. We install everything into GOBIN (both our go binaries and the language executor scripts) and when we `yarn link` to register packages we just link the version we built into the bin folder. Overall, this should simplify our story and make things a little more regular. We no longer require any directories to be created before building Pulumi.		2018-08-29 11:26:12 -07:00
..
pulumi	Allow eliding name in pulumi.Config .ctor	2018-08-06 16:03:54 -07:00
pulumi-language-go	Add output marshaling and improve input marsalling	2018-06-09 09:11:35 -07:00
Makefile	Remove the need for /opt/pulumi	2018-08-29 11:26:12 -07:00
README.md	Support Pulumi programs written in Go	2018-06-08 10:36:10 -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 update.