Build Status

Branch	Build
qas
main

---

Infraestrutura da aplicação

• Tipo da aplicação: "Api"

• Linux Container:

• Exemplo para criar uma imagem da aplicação:

podman build -t lzocateli/nome-da-aplicacao:9.9.9 -f .

#Excluir todas as imagens e containers
 docker rmi (docker images -q) -f

• Comando para executar o container no servidor:

sudo su -

podman run -d \
	-e DOTNET_ENVIRONMENT=Production \
	--env-file /userapps/tmp/ComicsApi/env.prd \
	--network=lzo \
	--network-alias=ComicsApi \
	--name ComicsApi \
	lzocateli/nuv.Comics.api:9.9.9

Para executar um container já existente alterando o entrypoint para o prompt /bin/bash
Note que sera necessario o arquivo com as variaveis de ambiente da aplicação

sudo su -

podman exec -it --env-file /userapps/tmp/ComicsApi/env.prd ComicsApi ls -la /app

---

• Instalação:
  • Automatizado via CI/CD DevOps

Servidor	Ambiente	Container Name	Container Image	Dns
seuservidor.com	Qualidade	ComicsApi	lzocateli/NUV.Comics.api:9.9.9-preview.22031603	Comics-api.zocate.li
seuservidor.com	Produção	ComicsApi	lzocateli/NUV.Comics.api:9.9.9	Comics-api.zocate.li

EF - Entity Framework Tutorial database first e Documentação oficial.

(Executar na pasta da solution)

• Instale o EF Core caso ainda não tenha:
  • Onde version é a versão do EF que sua aplicação esta utilizando.
  • Caso já possua o arquivo de manifesto (.config), basta executar: dotnet tool restore

dotnet new tool-manifest
dotnet tool install dotnet-ef --version 3.1.26

• Para gerar as classes baseado nas tabelas (Execute esses comandos na pasta onde esta a solution):: use o caractere ` antes de $ caso sua senha possua esse caractere

• PostgreSQL

  "ConnectionStrings": {
    "vendas": "Database=dddddddddddd;Host=ec2-34-205-209-14;Port=5432;User Id=zzzzzzzz;Password=xxxxxxxxxxxx;SSL Mode=Require;Trust Server Certificate=true;"
  },

• SqlServer

  "ConnectionStrings": {
    "vendas": "Server=seudominio.com.br;Initial Catalog=MeuDB;Integrated Security=False;User ID=zzzzzzz;Password=xxxxxxxxxx;Connect Timeout=15;Encrypt=False;TrustServerCertificate=True;ApplicationIntent=ReadWrite;MultiSubnetFailover=False"
  },

• Oracle

  "ConnectionStrings": {
    "vendas": "Data Source=(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=seudominio.com.br)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=test.blabla.com)));User ID=ZZZZZZZZZ;Password=xxxxxxxxxx;Persist Security Info=True;"
  },

• IBM DB2

  "ConnectionStrings": {
    "vendas": "Server=seudominio.com.br:3700;Database=MeuDb;UID=zzzzzzz;PWD=xxxxxxxxx;Connect Timeout=30;ConcurrentAccessResolution=SkipLockedData;IsolationLevel=ReadUncommitted"
  },

• Para gerar as classes do EFCore quando já existir o banco

dotnet ef dbcontext scaffold "Server=serverdb2.com:3700;Database=MEUBANCO;UID=XXXXXX;PWD=XXXXXXX;Connect Timeout=30;ConcurrentAccessResolution=SkipLockedData;IsolationLevel=ReadUncommitted" IBM.EntityFrameworkCore -s .\src\NUV.Comics.Api\NUV.Comics.Api.csproj -p .\src\NUV.Comics.Infra.Data\NUV.Comics.Infra.Data.csproj -c AppDbContext -v --schema "cadastro$" -t Comics --use-database-names --context-dir Data -o Models

• Para gerar as classes de migrations e o script (Execute esses comandos na pasta onde esta a solution):

dotnet ef migrations add CriacaoInicial -s .\src\NUV.Comics.Api\NUV.Comics.Api.csproj -p .\src\NUV.Comics.Infra.Data\NUV.Comics.Infra.Data.csproj -c AppDbContext -v

• Após executar o comando acima, onde sera criada a classe "CriacaoInicial", inclua o metodo abaixo no final do metodo Up gerado pela migration, bem como CustomViewMigration, caso tenha esses objtos no seu projeto:
  CustomFunctionMigration.UpFunctions(migrationBuilder);

dotnet ef migrations script -s .\src\NUV.Comics.Api\NUV.Comics.Api.csproj -p .\src\NUV.Comics.Infra.Data\NUV.Comics.Infra.Data.csproj -c AppDbContext -o .\src\NUV.Comics.Infra.Data\Migrations\Script\script.sql

---

Application Insights

Documentação Oficial

• Para Aspnet Core:
  • https://docs.microsoft.com/en-us/azure/azure-monitor/app/asp-net-core
  • https://docs.microsoft.com/en-us/azure/azure-monitor/app/sdk-connection-string?tabs=net
• Enable client-side telemetry for web applications Procure por: Enable client-side telemetry for web applications

---

Usando User Secrets para ambiente de desenvolvimento

Documentação Oficial

• Criando um storage local com secredos que irão substituir/adicionar chaves em appsettings.Development.json apenas em tempo de execução.

dotnet user-secrets init --id Global -p .\src\NUV.Comics.Api\NUV.Comics.Api.csproj

• Local onde é criado o arquivo no windows (no linux é igual, dentro da $HOME)
  C:\Users\lzob8c1\AppData\Roaming\Microsoft\UserSecrets\NUV.Comics.Api\secrets.json

• Copie ou crie sua ConnectionStrings ou qualquer outra chave, dentro do arquivo criado, ele ira substituir as chaves existentes no appsettings.Development.json ou incluir caso não exista, apenas em tempo de execução.

Caso não queira usar o arquivo secrets.json, renomeie para __secrets.json

---

Dicas e truques

• Criando uma Solution e incluindo ou removendo projetos nela

dotnet new sln -n SuaSolution (sem extenção)
dotnet sln SuaSolution.sln remove $(ls ./src/*/*.csproj)
dotnet sln SuaSolution.sln add $(ls ./src/*/*.csproj)

• Renomear os arquivos csproj e pastas do projeto

#Primeiro execute para Pastas
find ./src -type d -name 'NUV.Comics.*' -exec /bin/bash -c 'mv "$0" "${0/Comics/NovoNome}"' {} \;
#Depois para Arquivos
find ./src -type f -name 'NUV.Comics.*' -exec /bin/bash -c 'mv "$0" "${0/Comics/NovoNome}"' {} \;
#Soluction
mv ComicsApi.sln NovoNomeApi.sln

---

Arquitetura da aplicação