Moved tutorial to the top
@@ -12,14 +12,37 @@ To use buildpacks with Skaffold, please install the following tools:
* [pack](https://buildpacks.io/docs/install-pack/)
* [docker](https://docs.docker.com/install/)
-Once installed, you must choose a buildpack image to build your artifacts.
+## Tutorial
+
+Clone the Skaffold buildpacks [example](https://github.com/GoogleContainerTools/Skaffold/blob/master/examples/buildpacks/) for sample code.
+
+Set the default buildpack to one that can build Go applications:
+
+``` shell
+$ pack set-default-builder heroku/buildpacks
+```
+
+Now, you should be able to use Skaffold:
+
+```shell
+$ skaffold run --tail --default-repo <your repo>
+```
+This will deploy Hello World in Go to your cluster.
+
+**Note**: no Dockerfile was needed, as buildpacks containerized the application from source code.
+
+
+## Adding Buildpacks to Your Skaffold Project
+
+To use buildpacks with your own project, you must choose a buildpack image to build your artifacts.
To see a list of available buildpacks, run:
```shell
$ pack suggest-builders
```
-Choose a buildpack from the list, and set it with:
+Choose a buildpack from the list, making sure your chosen image can detect the runtime your project is written in.
+Set your default buildpack:
```shell
$ pack set-default-builder <insert buildpack image here>
@@ -27,8 +50,8 @@ $ pack set-default-builder <insert buildpack image here>
Now, configure your Skaffold config to build artifacts with buildpacks.
To do this, we will take advantage of the [custom builder](../builders) in Skaffold.
-First, add a `build.sh` file which Skaffold will call to build artifacts:
+First, add a `build.sh` file which Skaffold will call to build artifacts:
{{% readfile file="samples/buildpacks/build.sh" %}}
@@ -45,21 +68,3 @@ You can check buildpacks are properly configured by running `skaffold build`.
This command should build the artifacts and exit successfully.
-## Tutorial
-
-Clone the Skaffold buildpacks [example](https://github.com/GoogleContainerTools/Skaffold/blob/master/examples/buildpacks/) for sample code.
-
-Set the default buildpack to one that can build Go applications:
-
-``` shell
-$ pack set-default-builder heroku/buildpacks
-```
-
-Now, you should be able to use Skaffold:
-
-```shell
-$ skaffold run --tail --default-repo <your repo>
-```
-This will deploy Hello World in Go to your cluster.
-
-**Note**:, no Dockerfile was needed, as buildpacks containerized the application from source code.
