Skip to content

Commit

Permalink
Update tutorials
Browse files Browse the repository at this point in the history
  • Loading branch information
heroku-linguist[bot] committed Dec 17, 2024
1 parent 46ed97a commit f3eaf10
Show file tree
Hide file tree
Showing 2,045 changed files with 408,446 additions and 27 deletions.
64 changes: 37 additions & 27 deletions docs/dotnet/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
Instead modify the rundoc script and re-run it.
Command: /Users/rschneeman/.gem/ruby/3.3.1/bin/rundoc docs/src/dotnet/RUNDOC.md
Command: /home/runner/work/buildpacks/buildpacks/vendor/bundle/ruby/3.3.0/bin/rundoc docs/src/dotnet/RUNDOC.md
STOP -->

# Heroku .NET Cloud Native Buildpack (CNB) Tutorial
Expand Down Expand Up @@ -66,7 +66,7 @@ Buildpacks:
ID NAME VERSION HOMEPAGE
heroku/deb-packages Heroku .deb Packages 0.0.3 https://github.com/heroku/buildpacks-deb-packages
heroku/dotnet Heroku .NET 0.1.9 https://github.com/heroku/buildpacks-dotnet
heroku/go Heroku Go 0.4.7 https://github.com/heroku/buildpacks-go
heroku/go Heroku Go 0.5.0 https://github.com/heroku/buildpacks-go
heroku/gradle Heroku Gradle 6.0.4 https://github.com/heroku/buildpacks-jvm
heroku/java Heroku Java 6.0.4 https://github.com/heroku/buildpacks-jvm
heroku/jvm Heroku OpenJDK 6.0.4 https://github.com/heroku/buildpacks-jvm
Expand Down Expand Up @@ -95,7 +95,12 @@ $ cd dotnet-getting-started
Verify you're in the correct directory:

```
$ ls
$ ls -A
.config
.git
.gitattributes
.github
.gitignore
Frontend
GettingStarted.sln
LICENSE.txt
Expand Down Expand Up @@ -135,22 +140,22 @@ Skipping buildpack layer analysis
- Detected .NET file to publish: `/workspace/GettingStarted.sln`
- Inferring version requirement from `/workspace/GettingStarted.sln`
- Detected version requirement: `^8.0`
- Resolved .NET SDK version `8.0.404` (linux-arm64)
- Resolved .NET SDK version `8.0.404` (linux-amd64)
- SDK installation
- Downloading SDK from https://download.visualstudio.microsoft.com/download/pr/5ac82fcb-c260-4c46-b62f-8cde2ddfc625/feb12fc704a476ea2227c57c81d18cdf/dotnet-sdk-8.0.404-linux-arm64.tar.gz ................ (13.5s)
- Downloading SDK from https://download.visualstudio.microsoft.com/download/pr/4e3b04aa-c015-4e06-a42e-05f9f3c54ed2/74d1bb68e330eea13ecfc47f7cf9aeb7/dotnet-sdk-8.0.404-linux-x64.tar.gz .... (1.0s)
- Verifying SDK checksum
- Installing SDK
- Publish solution
- Using `Release` build configuration
- Running `dotnet publish /workspace/GettingStarted.sln --runtime linux-arm64 "-p:PublishDir=bin/publish"`
- Running `dotnet publish /workspace/GettingStarted.sln --runtime linux-x64 "-p:PublishDir=bin/publish"`
Determining projects to restore...
Restored /workspace/Frontend/Frontend.csproj (in 30.32 sec).
Frontend -> /workspace/Frontend/bin/Release/net8.0/linux-arm64/Frontend.dll
Restored /workspace/Frontend/Frontend.csproj (in 12.23 sec).
Frontend -> /workspace/Frontend/bin/Release/net8.0/linux-x64/Frontend.dll
Frontend -> /workspace/Frontend/bin/publish/
Restoring .NET tools
Tool 'dotnet-ef' (version '8.0.10') was restored. Available commands: dotnet-ef
Restore was successful.
Publishing executable database migration bundle
Build started...
Expand All @@ -159,11 +164,11 @@ Skipping buildpack layer analysis
Done. Migrations Bundle: /workspace/Frontend/bin/publish/efbundle
Don't forget to copy appsettings.json alongside your bundle if you need it to apply migrations.
- Done (40.0s)
- Done (28.8s)
- Setting launch table
- Detecting process types from published artifacts
- Added `Frontend`: bash -c cd Frontend/bin/publish; ./Frontend --urls http://*:$PORT
- Done (finished in 55.9s)
- Done (finished in 33.2s)
[Discovering process types]
Procfile declares types -> web
Expand All @@ -179,7 +184,7 @@ Adding label 'io.buildpacks.build.metadata'
Adding label 'io.buildpacks.project.metadata'
Setting default process type 'web'
Saving my-image-name...
*** Images (34cc0dc83a19):
*** Images (460bad50d36e):
my-image-name
Adding cache layer 'heroku/dotnet:nuget-cache'
Adding cache layer 'heroku/dotnet:sdk'
Expand All @@ -194,7 +199,7 @@ Verify that you see “Successfully built image my-image-name” at the end of t

```
$ docker image ls --format "table {{.ID}}\t{{.Repository}}\t{{.Tag}}" | grep my-image-name
34cc0dc83a19 my-image-name latest
460bad50d36e my-image-name latest
```
<!-- STOP. This document is autogenerated. Do not manually modify. See the top of the doc for more details. -->
## What does `pack build` do?
Expand All @@ -218,7 +223,7 @@ Skipping buildpack layer analysis
After the detect phase, each buildpack will execute. Buildpacks can inspect your project, install files to disk, run commands, write environment variables, [and more](https://buildpacks.io/docs/for-buildpack-authors/). You can see some examples of that in the output above. For example, the .NET buildpack installs dependencies from the `Frontend.csproj` automatically:

```
- Running `dotnet publish /workspace/GettingStarted.sln --runtime linux-arm64 "-p:PublishDir=bin/publish"`
- Running `dotnet publish /workspace/GettingStarted.sln --runtime linux-x64 "-p:PublishDir=bin/publish"`
```
<!-- STOP. This document is autogenerated. Do not manually modify. See the top of the doc for more details. -->

Expand All @@ -234,7 +239,7 @@ $ docker run -it --rm --env PORT=5006 -p 5006:5006 my-image-name
warn: Microsoft.AspNetCore.DataProtection.Repositories.FileSystemXmlRepository[60]
Storing keys in a directory '/home/heroku/.aspnet/DataProtection-Keys' that may not be persisted outside of the container. Protected data will be unavailable when container is destroyed. For more information go to https://aka.ms/aspnet/dataprotectionwarning
warn: Microsoft.AspNetCore.DataProtection.KeyManagement.XmlKeyManager[35]
No XML encryptor configured. Key {2b312d6e-ac53-4ea5-b31f-f327da08ec51} may be persisted to storage in unencrypted form.
No XML encryptor configured. Key {2e04de8b-7456-4a12-abcf-56423011a052} may be persisted to storage in unencrypted form.
info: Microsoft.Hosting.Lifetime[14]
Now listening on: http://[::]:5006
info: Microsoft.Hosting.Lifetime[0]
Expand Down Expand Up @@ -274,7 +279,12 @@ $ docker run -it --rm my-image-name bash
Now you can inspect the container interactively. For example, you can see the files on disk with `ls`:

```
$ ls
$ ls -A
.config
.git
.gitattributes
.github
.gitignore
Frontend
GettingStarted.sln
LICENSE.txt
Expand Down Expand Up @@ -381,7 +391,7 @@ $ pack build my-image-name --path .
===> ANALYZING
Image with name "my-image-name" not found
===> DETECTING
heroku/python 0.20.0
heroku/python 0.20.1
heroku/dotnet 0.1.9
heroku/procfile 3.1.2
===> RESTORING
Expand Down Expand Up @@ -409,22 +419,22 @@ Running 'pip install -r requirements.txt'
- Detected .NET file to publish: `/workspace/GettingStarted.sln`
- Inferring version requirement from `/workspace/GettingStarted.sln`
- Detected version requirement: `^8.0`
- Resolved .NET SDK version `8.0.404` (linux-arm64)
- Resolved .NET SDK version `8.0.404` (linux-amd64)
- SDK installation
- Downloading SDK from https://download.visualstudio.microsoft.com/download/pr/5ac82fcb-c260-4c46-b62f-8cde2ddfc625/feb12fc704a476ea2227c57c81d18cdf/dotnet-sdk-8.0.404-linux-arm64.tar.gz .............. (11.4s)
- Downloading SDK from https://download.visualstudio.microsoft.com/download/pr/4e3b04aa-c015-4e06-a42e-05f9f3c54ed2/74d1bb68e330eea13ecfc47f7cf9aeb7/dotnet-sdk-8.0.404-linux-x64.tar.gz .... (1.3s)
- Verifying SDK checksum
- Installing SDK
- Publish solution
- Using `Release` build configuration
- Running `dotnet publish /workspace/GettingStarted.sln --runtime linux-arm64 "-p:PublishDir=bin/publish"`
- Running `dotnet publish /workspace/GettingStarted.sln --runtime linux-x64 "-p:PublishDir=bin/publish"`
Determining projects to restore...
Restored /workspace/Frontend/Frontend.csproj (in 26.93 sec).
Frontend -> /workspace/Frontend/bin/Release/net8.0/linux-arm64/Frontend.dll
Restored /workspace/Frontend/Frontend.csproj (in 9.2 sec).
Frontend -> /workspace/Frontend/bin/Release/net8.0/linux-x64/Frontend.dll
Frontend -> /workspace/Frontend/bin/publish/
Restoring .NET tools
Tool 'dotnet-ef' (version '8.0.10') was restored. Available commands: dotnet-ef
Restore was successful.
Publishing executable database migration bundle
Build started...
Expand All @@ -433,11 +443,11 @@ Running 'pip install -r requirements.txt'
Done. Migrations Bundle: /workspace/Frontend/bin/publish/efbundle
Don't forget to copy appsettings.json alongside your bundle if you need it to apply migrations.
- Done (37.3s)
- Done (26.5s)
- Setting launch table
- Detecting process types from published artifacts
- Added `Frontend`: bash -c cd Frontend/bin/publish; ./Frontend --urls http://*:$PORT
- Done (finished in 51.4s)
- Done (finished in 31.3s)
[Discovering process types]
Procfile declares types -> web
Expand All @@ -455,7 +465,7 @@ Adding label 'io.buildpacks.build.metadata'
Adding label 'io.buildpacks.project.metadata'
Setting default process type 'web'
Saving my-image-name...
*** Images (73c0b944e8fc):
*** Images (e955ad0ee4e1):
my-image-name
Adding cache layer 'heroku/python:pip'
Adding cache layer 'heroku/python:pip-cache'
Expand All @@ -480,7 +490,7 @@ Most buildpacks rely on existing community standards to allow you to configure y

The `Procfile` is a configuration file format that was [introduced by Heroku in 2011](https://devcenter.heroku.com/articles/procfile), you can now use this behavior on your CNB-powered application via the `heroku/procfile`, which like the rest of the buildpacks in our builder [is open source](https://github.com/heroku/buildpacks-procfile). The `heroku/procfile` buildpack allows you to configure your web startup process.

This is the `Procfile` of the getting started guide:
This is the `web` entry in the getting started guide's `Procfile`:

```
web: cd Frontend/bin/publish/; ./Frontend --urls http://*:$PORT
Expand Down
Binary file modified docs/dotnet/screenshots/screenshot_1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
29 changes: 29 additions & 0 deletions vendor/bundle/ruby/3.3.0/bin/dotenv
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
#!/usr/bin/env ruby
#
# This file was generated by RubyGems.
#
# The application 'dotenv' is installed as part of a gem, and
# this file is here to facilitate running it.
#

require 'rubygems'

Gem.use_gemdeps

version = ">= 0.a"

str = ARGV.first
if str
str = str.b[/\A_(.*)_\z/, 1]
if str and Gem::Version.correct?(str)
version = str
ARGV.shift
end
end

if Gem.respond_to?(:activate_bin_path)
load Gem.activate_bin_path('dotenv', 'dotenv', version)
else
gem "dotenv", version
load Gem.bin_path("dotenv", "dotenv", version)
end
29 changes: 29 additions & 0 deletions vendor/bundle/ruby/3.3.0/bin/jmespath.rb
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
#!/usr/bin/env ruby
#
# This file was generated by RubyGems.
#
# The application 'jmespath' is installed as part of a gem, and
# this file is here to facilitate running it.
#

require 'rubygems'

Gem.use_gemdeps

version = ">= 0.a"

str = ARGV.first
if str
str = str.b[/\A_(.*)_\z/, 1]
if str and Gem::Version.correct?(str)
version = str
ARGV.shift
end
end

if Gem.respond_to?(:activate_bin_path)
load Gem.activate_bin_path('jmespath', 'jmespath.rb', version)
else
gem "jmespath", version
load Gem.bin_path("jmespath", "jmespath.rb", version)
end
29 changes: 29 additions & 0 deletions vendor/bundle/ruby/3.3.0/bin/nokogiri
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
#!/usr/bin/env ruby
#
# This file was generated by RubyGems.
#
# The application 'nokogiri' is installed as part of a gem, and
# this file is here to facilitate running it.
#

require 'rubygems'

Gem.use_gemdeps

version = ">= 0.a"

str = ARGV.first
if str
str = str.b[/\A_(.*)_\z/, 1]
if str and Gem::Version.correct?(str)
version = str
ARGV.shift
end
end

if Gem.respond_to?(:activate_bin_path)
load Gem.activate_bin_path('nokogiri', 'nokogiri', version)
else
gem "nokogiri", version
load Gem.bin_path("nokogiri", "nokogiri", version)
end
29 changes: 29 additions & 0 deletions vendor/bundle/ruby/3.3.0/bin/racc
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
#!/usr/bin/env ruby
#
# This file was generated by RubyGems.
#
# The application 'racc' is installed as part of a gem, and
# this file is here to facilitate running it.
#

require 'rubygems'

Gem.use_gemdeps

version = ">= 0.a"

str = ARGV.first
if str
str = str.b[/\A_(.*)_\z/, 1]
if str and Gem::Version.correct?(str)
version = str
ARGV.shift
end
end

if Gem.respond_to?(:activate_bin_path)
load Gem.activate_bin_path('racc', 'racc', version)
else
gem "racc", version
load Gem.bin_path("racc", "racc", version)
end
29 changes: 29 additions & 0 deletions vendor/bundle/ruby/3.3.0/bin/rundoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
#!/usr/bin/env ruby
#
# This file was generated by RubyGems.
#
# The application 'rundoc' is installed as part of a gem, and
# this file is here to facilitate running it.
#

require 'rubygems'

Gem.use_gemdeps

version = ">= 0.a"

str = ARGV.first
if str
str = str.b[/\A_(.*)_\z/, 1]
if str and Gem::Version.correct?(str)
version = str
ARGV.shift
end
end

if Gem.respond_to?(:activate_bin_path)
load Gem.activate_bin_path('rundoc', 'rundoc', version)
else
gem "rundoc", version
load Gem.bin_path("rundoc", "rundoc", version)
end
29 changes: 29 additions & 0 deletions vendor/bundle/ruby/3.3.0/bin/thor
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
#!/usr/bin/env ruby
#
# This file was generated by RubyGems.
#
# The application 'thor' is installed as part of a gem, and
# this file is here to facilitate running it.
#

require 'rubygems'

Gem.use_gemdeps

version = ">= 0.a"

str = ARGV.first
if str
str = str.b[/\A_(.*)_\z/, 1]
if str and Gem::Version.correct?(str)
version = str
ARGV.shift
end
end

if Gem.respond_to?(:activate_bin_path)
load Gem.activate_bin_path('thor', 'thor', version)
else
gem "thor", version
load Gem.bin_path("thor", "thor", version)
end
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/dotenv-3.1.6.gem
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/jmespath-1.6.2.gem
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/logger-1.6.3.gem
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/matrix-0.4.2.gem
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/racc-1.8.1.gem
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/rack-3.1.8.gem
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/rexml-3.3.9.gem
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/rubyzip-2.3.2.gem
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/thor-1.3.2.gem
Binary file not shown.
Binary file not shown.
Binary file added vendor/bundle/ruby/3.3.0/cache/xpath-3.2.0.gem
Binary file not shown.
Empty file.
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
current directory: /home/runner/work/buildpacks/buildpacks/vendor/bundle/ruby/3.3.0/gems/racc-1.8.1/ext/racc/cparse
/opt/hostedtoolcache/Ruby/3.3.6/x64/bin/ruby extconf.rb
creating Makefile

current directory: /home/runner/work/buildpacks/buildpacks/vendor/bundle/ruby/3.3.0/gems/racc-1.8.1/ext/racc/cparse
make DESTDIR\= sitearchdir\=./.gem.20241217-2671-3l0hum sitelibdir\=./.gem.20241217-2671-3l0hum clean

current directory: /home/runner/work/buildpacks/buildpacks/vendor/bundle/ruby/3.3.0/gems/racc-1.8.1/ext/racc/cparse
make DESTDIR\= sitearchdir\=./.gem.20241217-2671-3l0hum sitelibdir\=./.gem.20241217-2671-3l0hum
compiling cparse.c
linking shared-object racc/cparse.so

current directory: /home/runner/work/buildpacks/buildpacks/vendor/bundle/ruby/3.3.0/gems/racc-1.8.1/ext/racc/cparse
make DESTDIR\= sitearchdir\=./.gem.20241217-2671-3l0hum sitelibdir\=./.gem.20241217-2671-3l0hum install
/usr/bin/install -c -m 0755 cparse.so ./.gem.20241217-2671-3l0hum/racc

current directory: /home/runner/work/buildpacks/buildpacks/vendor/bundle/ruby/3.3.0/gems/racc-1.8.1/ext/racc/cparse
make DESTDIR\= sitearchdir\=./.gem.20241217-2671-3l0hum sitelibdir\=./.gem.20241217-2671-3l0hum clean
Binary file not shown.
Loading

0 comments on commit f3eaf10

Please sign in to comment.