Precisa ter instalado os pacotes abaixo:
A partir do terminal Windows PowerShell, Git Bash ou próprio Prompt de Comando do Windows, vamos criar um novo diretório do projeto e inicializar um novo projeto C# webapi:
mkdir dotnet-example
cd dotnet-example
dotnet new webapi
Em seguida, vamos restaurar e executar a nossa API:
dotnet restore
dotnet run
E, finalmente, em uma segunda janela de terminal, vamos testar a API com curl:
curl http://localhost:5000/api/values
Agora é hora de adicionar um banco de dados. Graças ao Docker, é super rápido e fácil de começar com isso. Do terminal, vamos baixar e executar uma nova instância do SQL Server para Linux como um novo container Docker.
No caso do Windows 10, ao invés de aspas simples, usar aspas duplas.
docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=SqlExpress123" -e "MSSQL_PID=Express" -p 1433:1433 --name sqlexpress -d microsoft/mssql-server-linux
Verificar se o container Docker do SQL Server sqlexpress está no ar:
docker ps -a
Abrir o Visual Studio Code via terminal, digitar de dentro da pasta do projeto dotnet-example
code .
Acessando o Menu > View > Integrated Terminal você irá adicionar a package Microsoft SQL Server database provider for Entity Framework Core ao projeto:
dotnet add package Microsoft.EntityFrameworkCore.SqlServer --version 2.0.1
Criar arquivo na pasta Models > Product.cs
using System.ComponentModel.DataAnnotations;
namespace dotnet_example.Models
{
public class Product
{
public int Id { get; set; }
[Required]
public string Name { get; set; }
public decimal Price { get; set; }
}
}Criar arquivo na pasta Models > ApiContext.cs
using Microsoft.EntityFrameworkCore;
namespace dotnet_example.Models
{
public class ApiContext : DbContext
{
public ApiContext(DbContextOptions<ApiContext> options)
: base(options)
{
this.Database.EnsureCreated();
}
public DbSet<Product> Products { get; set; }
}
}Criar arquivo na pasta Controllers > ProductsController.cs
using System.Linq;
using Microsoft.AspNetCore.Mvc;
using dotnet_example.Models;
namespace dotnet_example.Controllers
{
[Route("api/[controller]")]
public class ProductsController : Controller
{
private readonly ApiContext _context;
public ProductsController(ApiContext context)
{
_context = context;
}
// GET api/values
[HttpGet]
public IActionResult Get()
{
var model = _context.Products.ToList();
return Ok(new { Products = model });
}
[HttpPost]
public IActionResult Create([FromBody]Product model)
{
if (!ModelState.IsValid)
return BadRequest(ModelState);
_context.Products.Add(model);
_context.SaveChanges();
return Ok(model);
}
[HttpPut("{id}")]
public IActionResult Update(int id, [FromBody]Product model)
{
if (!ModelState.IsValid)
return BadRequest(ModelState);
var product = _context.Products.Find(id);
if (product == null)
{
return NotFound();
}
product.Name = model.Name;
product.Price = model.Price;
_context.SaveChanges();
return Ok(product);
}
[HttpDelete("{id}")]
public IActionResult Delete(int id)
{
var product = _context.Products.Find(id);
if (product == null)
{
return NotFound();
}
_context.Remove(product);
_context.SaveChanges();
return Ok(product);
}
}
}Atualizar método ConfigureServices do arquivo Startup.cs
var hostname = Environment.GetEnvironmentVariable("SQLSERVER_HOST") ?? "localhost";
var password = Environment.GetEnvironmentVariable("SQLSERVER_SA_PASSWORD") ?? "SqlExpress123";
var connString = $"Data Source={hostname};Initial Catalog=dotnet_example;User ID=sa;Password={password};";
services.AddDbContext<ApiContext>(options => options.UseSqlServer(connString));Adicionar dependencias
using dotnet_example.Models;
using Microsoft.EntityFrameworkCore;Agora que temos o nosso aplicativo, precisamos obtê-lo em Docker. O primeiro passo é criar um novo Dockerfile que diz ao Docker como construir o nosso aplicativo. Crie um arquivo na pasta raiz chamada Dockerfile e adicione o seguinte conteúdo:
FROM microsoft/aspnetcore-build AS build
WORKDIR /app
# Copy csproj and restore as distinct layers
COPY *.csproj ./
RUN dotnet restore
# Copy everything else and build
COPY . ./
RUN dotnet publish -c Release -o out
# Build runtime image
FROM microsoft/aspnetcore
WORKDIR /app
COPY --from=build /app/out .
ENTRYPOINT ["dotnet", "dotnet-example.dll"]Em seguida, é preciso compilar o nosso aplicativo:
docker build -t dotnet-example .
E, finalmente, podemos executar nosso novo container dotnet-example, relacionando-a com o nosso container sqlexpress:
docker run -it --rm -p 5000:80 --link sqlexpress -e SQLSERVER_HOST=sqlexpress dotnet-example
ou
docker run -it --rm -p 5000:80 --link sqlexpress -e SQLSERVER_HOST=sqlexpress --name webapi-aspnetcore dotnet-example
Vamos usar curl para postar alguns dados para nossa API:
curl -i -H "Content-Type: application/json" -X POST -d '{"name": "Teste 123", "price": "5.99"}' http://localhost:5000/api/products
Se tudo correr bem, você deve ver uma resposta status 200, e nosso novo produto retornados como JSON.
Em seguida, vamos modificar os nossos dados com um PUT e alterar o preço:
curl -i -H "Content-Type: application/json" -X PUT -d '{"name": "Teste", "price": "7.99"}' http://localhost:5000/api/products/1
Claro, também podemos obter os nossos dados:
curl -i http://localhost:5000/api/products
E, finalmente, podemos excluí-lo:
curl -i -X DELETE http://localhost:5000/api/products/1
Conectar no SQL Server via terminal:
docker exec -it sqlexpress /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P SqlExpress123
Exemplo de query:
1> use dotnet_example
2> select * from products
3> go