42 lines
1.8 KiB
Markdown
42 lines
1.8 KiB
Markdown
|
dotnet-bot Sample
|
||
|
================
|
||
|
|
||
|
The dotnet-bot sample demonstrates "hello world" type usage of .NET Core. It displays [dotnet-bot](https://github.com/dotnet-bot), the open source mascot for .NET Core projects. This sample is very similar to the Docker [whalesay](https://docs.docker.com/engine/getstarted/step_three/) sample.
|
||
|
|
||
|
Topics
|
||
|
------
|
||
|
|
||
|
You will exercise the following topics in this sample.
|
||
|
|
||
|
- Building and running a .NET Core application.
|
||
|
- Creating a Docker image for a .NET Core application.
|
||
|
- Running a .NET Core application in container.
|
||
|
|
||
|
Script
|
||
|
------
|
||
|
|
||
|
Follow these steps to try out this sample. The instructions are intended to be Operating System agnostic, unless called out.
|
||
|
|
||
|
**Preparing your Environment**
|
||
|
|
||
|
1. Install the [.NET Core SDK](https://dot.net/core) for your operating system.
|
||
|
2. Git clone this repository or otherwise copy this sample to your machine: `git clone https://github.com/dotnet/core/`
|
||
|
3. Navigate to the sample on your machine at the command prompt or terminal.
|
||
|
|
||
|
**Run the application**
|
||
|
|
||
|
4. Restore dependencies: `dotnet restore`
|
||
|
5. Run application: `dotnet run`
|
||
|
6. Alternatively, you can build and directly run your application with the following two commands:
|
||
|
- `dotnet build`
|
||
|
- `dotnet bin/Debug/netcoreapp1.0/dotnetbot.dll`
|
||
|
7. You can also try passing input to the sample to get the dotnet-bot to say something: `dotnet run dotnet-bot is a great teacher`
|
||
|
|
||
|
**Dockerize the application**
|
||
|
|
||
|
The Docker instructions are OS agnostic, however, the Dockerfile used relies on a Linux image.
|
||
|
|
||
|
8. Install the [Docker tools](https://www.docker.com/products/docker) for your operating system.
|
||
|
9. Build a Docker container, as specified by the [Dockerfile](Dockerfile): `docker build -t dotnetbot .`
|
||
|
10. Run the application in the container: `docker run dotnetbot Hello .NET Core from Docker`
|