Skip to content

claudiobastos/dosenanuvem-customers

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

38 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

customers

Cadastro dos nossos clientes

Como executar o linter localmente

golangci-lint run ./...

Arquivos locais

Para o desenvolvimento de nossa aplicação, precisamos de alguns arquivos locais, como o arquivo de configuração e os certificados TLS. As ferramentas deste projeto partem do pressuposto que estes arquivos estão no diretório local, organizados da seguinte forma:

local
├── certs
│   ├── ca.pem
│   ├── cert-key.pem
│   └── cert.pem
└── config.yaml

Servidor em modo seguro com TLS

Com o objetivo de sustentar boas práticas no desenvolvimento de apps cloud natives, o nosso servidor Customers exigirá TLS.

Assim, será necessário configurar um certificado de serviço para o seu funcionamento, e para o ambiente de desenvolvimento, iremos usar um certificado auto-assinado.

A geração de certificados auto-assinados pode ser feita seguindo o artigo https://medium.com/opentelemetry/securing-your-opentelemetry-collector-1a4f9fa5bd6f

Como o artigo está em inglês e queremos fornecer um material que os brasileiros podem usar, o resumo para as instruções é o seguinte:

  • crie uma pasta local tmp e acesse-a
  • instale a ferramenta open-source cfssl que nos permitirá a criação dos certificados
  • crie um arquivo ca-csr.json necessário para a autoridade certificadora (CA). Use como exemplo o trecho abaixo
{
    "hosts": [
        "localhost",
        "127.0.0.1"
    ],
    "key": {
        "algo": "rsa",
        "size": 2048
    },
    "names": [
        {
            "O":  "Customers (Projeto Dose na Nuvem)"
        }
    ]
}
  • execute o comando:

cfssl genkey -initca ca-csr.json | cfssljson -bare ca

  • crie um arquivo cert-csr.json necessário para o certificado do serviço. Use como exemplo o trecho abaixo
{
    "hosts": [
        "localhost",
        "127.0.0.1"
    ],
    "key": {
        "algo": "rsa",
        "size": 2048
    },
    "names": [
        {
            "O":  "Customers (Projeto Dose na Nuvem)"
        }
    ]
}
  • execute o comando:

cfssl gencert -ca ca.pem -ca-key ca-key.pem cert-csr.json | cfssljson -bare cert

Os arquivos importantes para execução no modo seguro são:

  • cert.pem
  • cert-key.pem

Use esses certificados para execução do servidor

1 - via arquivo de configuração. Acrescente o seguinte trecho no arquivo config.yaml.

tls:
  cert_file: local/certs/cert.pem
  cert_key_file: local/certs/cert-key.pem

2 - via linha de comando

go run . start --config config.yaml --server.tls.certfile tmp/cert.pem --server.tls.certkeyfile tmp/cert-key.pem

Live reload

Para facilitar o desenvolvimento, automatizando a execução do seu app a cada mudança de código, você pode usar o software opensource Air.

Para instalar o Air:

go install github.com/cosmtrek/air@latest

Revise o comando de inicialização do app na seção [build] do .air.toml e então simplesmente execute air.

Project's Toolkit

About

Cadastro dos nossos clientes - Dose na Nuvem

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 94.7%
  • Makefile 5.3%