DM106 - Blog

❓ Sobre o projeto

Este projeto da disciplina DM106 (Desenvolvimento de Web Services com segurança sob plataforma .NET) tem como objetivo criar uma API REST para gerenciar um Blog.

Para isso, foi utilizado o framework .NET Core 7.0, Azure SQL e a Azure Web App.

💻 Tecnologias

As seguintes tecnologias foram utilizadas na construção do projeto:

Para mais detalhes, veja o arquivo Tasks.csproj

Utilitários

Editor: Visual Studio Code

⚙️ Como executar o projeto

💡 Pré-requisitos

Antes de começar, você vai precisar ter instalado em sua máquina as seguintes ferramentas: Git e .NET;

# Clone este repositório
$ git clone https://github.com/Brendhon/dm106-tasks.git

# Acesse a pasta do projeto

# Limpe o projeto
$ dotnet clean

# Build da aplicação
$ dotnet build

É necessário também ter uma conta na Azure, criar um banco de dados SQL, criar uma Web App e criar um arquivo appsettings.json na raiz do projeto com a seguinte estrutura:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "AZURE_SQL_CONNECTION": "<connection-string-do-banco-de-dados>"
  }
}

⚽ Rodando no modo desenvolvedor

É necessário a criação de um arquivo appsettings.Development.json na raiz do projeto com a mesma estrutura do arquivo appsettings.json.

Após isso, execute o seguinte comando:

# Execute a aplicação
$ dotnet run

# Iniciará na porta:500

Comandos úteis

# Gerando o arquivo de migração
$ dotnet ef migrations add <nome da migration> --context <nome do contexto>

# Após fazer a migração no comando anterior, vamos agora aplicar essas migrações no banco
$ dotnet ef database update

# Aplicar as migrações em um banco de dados específico
$ dotnet ef database update --connection "<your-azure-sql-connection-string>" --context TaskContext

# Para remover uma migração e que inclusive já foi enviada para o banco, use
$ dotnet ef migrations remove
$ dotnet ef database update

# Para gerar o script SQL do banco, use o comando
$ dotnet ef migrations script -o ./script.sql

Observações

Foi adicionado um arquivo do Postman na raiz do projeto para testar a API.
Lembrando que é necessário habilitar o acesso ao banco de dados do Azure para o IP da sua máquina, caso contrário, não será possível acessar o banco de dados.
Após executar a aplicação, acesse a documentação da API em: http://localhost:5000/swagger/index.html
Lembre-se, sempre que alterar o banco de dados, é necessário criar uma nova migration e atualizar o banco de dados, para isso, utilize os comando acima.
Caso use o Visual Studio Code, recomendo que instale as seguintes extensões para facilitar o desenvolvimento:
- Azure App Service
- C#
- Azure Account