Merge pull request cds-hooks#426 from Phantsure/issue-246

Changes to Buildpack author tutorial for compatibility with Buildpack API 0.6

Author: sambhav

content/docs/buildpack-author-guide/create-buildpack/adding-bill-of-materials.md

@@ -76,7 +76,7 @@ ruby_url=https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/heroku-18/rub
 wget -q -O - "$ruby_url" | tar -xzf - -C "$rubylayer"
 
 # 4. MAKE RUBY AVAILABLE DURING LAUNCH
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 
 # 5. MAKE RUBY AVAILABLE TO THIS SCRIPT
 export PATH="$rubylayer"/bin:$PATH
@@ -102,6 +102,7 @@ else
     echo "---> Installing gems"
     mkdir -p "$bundlerlayer"
     cat > "$layersdir/bundler.toml" <<EOL
+[types]
 cache = true
 launch = true
 
@@ -118,6 +119,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 
 # our worker process
 [[processes]]

content/docs/buildpack-author-guide/create-buildpack/build-app.md

@@ -47,7 +47,7 @@ This code uses the `wget` tool to download the Ruby binaries from the given URL,
 The last step in creating a layer is writing a TOML file that contains metadata about the layer. The TOML file's name must match the name of the layer (in this example it's `ruby.toml`). Without this file, the Buildpack lifecycle will ignore the layer directory. For the Ruby layer, we need to ensure it is available in the launch image by setting the `launch` key to `true`. Add the following code to the build script:
 
 ```bash
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 ```
 
 ### Installing Dependencies
@@ -96,7 +96,7 @@ ruby_url=https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/heroku-18/rub
 wget -q -O - "$ruby_url" | tar -xzf - -C "$rubylayer"
 
 # 4. MAKE RUBY AVAILABLE DURING LAUNCH
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 
 # 5. MAKE RUBY AVAILABLE TO THIS SCRIPT
 export PATH="$rubylayer"/bin:$PATH

content/docs/buildpack-author-guide/create-buildpack/building-blocks-cnb.md

@@ -17,7 +17,7 @@ Example:
 <!-- test:exec -->
 ```bash
 pack buildpack new examples/ruby \
-    --api 0.5 \
+    --api 0.6 \
     --path ruby-buildpack \
     --version 0.0.1 \
     --stacks io.buildpacks.samples.stacks.bionic
@@ -40,7 +40,7 @@ You will have `buildpack.toml` in your buildpack directory to describe our build
 <!-- test:file=ruby-buildpack/buildpack.toml -->
 ```toml
 # Buildpack API version
-api = "0.5"
+api = "0.6"
 
 # Buildpack ID and metadata
 [buildpack]

content/docs/buildpack-author-guide/create-buildpack/caching.md

@@ -22,7 +22,7 @@ with the following:
 echo "---> Installing gems"
 bundlerlayer="$layersdir/bundler"
 mkdir -p "$bundlerlayer"
-echo -e 'cache = true\nlaunch = true' > "$layersdir/bundler.toml"
+echo -e '[types]\ncache = true\nlaunch = true' > "$layersdir/bundler.toml"
 bundle config set --local path "$bundlerlayer" && bundle install && bundle binstubs --all --path "$bundlerlayer/bin"
 
 ```
@@ -49,7 +49,7 @@ ruby_url=https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/heroku-18/rub
 wget -q -O - "$ruby_url" | tar -xzf - -C "$rubylayer"
 
 # 4. MAKE RUBY AVAILABLE DURING LAUNCH
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 
 # 5. MAKE RUBY AVAILABLE TO THIS SCRIPT
 export PATH="$rubylayer"/bin:$PATH
@@ -64,7 +64,7 @@ gem install bundler --no-ri --no-rdoc
 echo "---> Installing gems"
 bundlerlayer="$layersdir/bundler"
 mkdir -p "$bundlerlayer"
-echo -e 'cache = true\nlaunch = true' > "$layersdir/bundler.toml"
+echo -e '[types]\ncache = true\nlaunch = true' > "$layersdir/bundler.toml"
 bundle config set --local path "$bundlerlayer" && bundle install && bundle binstubs --all --path "$bundlerlayer/bin"
 
 # 8. SET DEFAULT START COMMAND
@@ -73,6 +73,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 
 # our worker process
 [[processes]]
@@ -136,7 +137,7 @@ Replace the gem installation logic from the previous step:
 echo "---> Installing gems"
 bundlerlayer="$layersdir/bundler"
 mkdir -p "$bundlerlayer"
-echo -e 'cache = true\nlaunch = true' > "$layersdir/bundler.toml"
+echo -e '[types]\ncache = true\nlaunch = true' > "$layersdir/bundler.toml"
 bundle config set --local path "$bundlerlayer" && bundle install && bundle binstubs --all --path "$bundlerlayer/bin"
 
 
@@ -165,6 +166,7 @@ else
     echo "---> Installing gems"
     mkdir -p "$bundlerlayer"
     cat > "$layersdir/bundler.toml" <<EOL
+[types]
 cache = true
 launch = true
 
@@ -198,7 +200,7 @@ ruby_url=https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/heroku-18/rub
 wget -q -O - "$ruby_url" | tar -xzf - -C "$rubylayer"
 
 # 4. MAKE RUBY AVAILABLE DURING LAUNCH
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 
 # 5. MAKE RUBY AVAILABLE TO THIS SCRIPT
 export PATH="$rubylayer"/bin:$PATH
@@ -225,6 +227,7 @@ else
     echo "---> Installing gems"
     mkdir -p "$bundlerlayer"
     cat > "$layersdir/bundler.toml" <<EOL
+[types]
 cache = true
 launch = true
 
@@ -241,6 +244,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 
 # our worker process
 [[processes]]

content/docs/buildpack-author-guide/create-buildpack/make-app-runnable.md

@@ -15,6 +15,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 EOL
 
 # ...
@@ -42,7 +43,7 @@ ruby_url=https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/heroku-18/rub
 wget -q -O - "$ruby_url" | tar -xzf - -C "$rubylayer"
 
 # 4. MAKE RUBY AVAILABLE DURING LAUNCH
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 
 # 5. MAKE RUBY AVAILABLE TO THIS SCRIPT
 export PATH="$rubylayer"/bin:$PATH
@@ -62,6 +63,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 EOL
 ```
 

content/docs/buildpack-author-guide/create-buildpack/make-buildpack-configurable.md

@@ -63,7 +63,7 @@ ruby_url=https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/heroku-18/rub
 wget -q -O - "$ruby_url" | tar -xzf - -C "$rubylayer"
 
 # 4. MAKE RUBY AVAILABLE DURING LAUNCH
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 
 # 5. MAKE RUBY AVAILABLE TO THIS SCRIPT
 export PATH="$rubylayer"/bin:$PATH
@@ -89,6 +89,7 @@ else
     echo "---> Installing gems"
     mkdir -p "$bundlerlayer"
     cat > "$layersdir/bundler.toml" <<EOL
+[types]
 cache = true
 launch = true
 
@@ -105,6 +106,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 
 # our worker process
 [[processes]]

content/docs/buildpack-author-guide/create-buildpack/specify-multiple-process-types.md

@@ -28,6 +28,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 
 # our worker process
 [[processes]]
@@ -60,7 +61,7 @@ ruby_url=https://s3-external-1.amazonaws.com/heroku-buildpack-ruby/heroku-18/rub
 wget -q -O - "$ruby_url" | tar -xzf - -C "$rubylayer"
 
 # 4. MAKE RUBY AVAILABLE DURING LAUNCH
-echo -e 'launch = true' > "$layersdir/ruby.toml"
+echo -e '[types]\nlaunch = true' > "$layersdir/ruby.toml"
 
 # 5. MAKE RUBY AVAILABLE TO THIS SCRIPT
 export PATH="$rubylayer"/bin:$PATH
@@ -81,6 +82,7 @@ cat > "$layersdir/launch.toml" <<EOL
 [[processes]]
 type = "web"
 command = "bundle exec ruby app.rb"
+default = true
 
 # our worker process
 [[processes]]