harness

Aproveitar

O arnês de código aberto é uma plataforma de desenvolvimento de código aberto repleto de poder de hospedagem de código, pipelines de DevOps automatizados, ambientes de desenvolvimento hospedados (GitsPaces) e registros de artefatos.

Visão geral

O arnês de código aberto é uma plataforma de desenvolvimento de código aberto repleto de poder de hospedagem de código, pipelines de DevOps automatizados, espaços gits e registros de artefatos.

Correndo de arnês localmente

A mais recente imagem do Docker divulgada publicamente pode ser encontrada no arnês/arnês.

Para instalar o arnês, basta executar o comando abaixo. Depois que o contêiner terminar, você pode visitar http: // localhost: 3000 no seu navegador.

docker run -d 
  -p 3000:3000 
  -p 22:22 
  -v /var/run/docker.sock:/var/run/docker.sock 
  -v /tmp/harness:/data 
  --name harness 
  --restart always 
  harness/harness

A imagem do arnês usa um volume para armazenar o banco de dados e os repositórios. É altamente recomendável usar uma montagem de ligação ou volume nomeado, caso contrário todos os dados serão perdidos assim que o contêiner for interrompido.

Consulte o desenvolvedor.harness.io para aprender a tirar o máximo proveito do arnês.

Onde está o drone?

O arnês de código aberto representa um investimento maciço na próxima geração de drones. Onde o drone se concentrou apenas na integração contínua, o arnês adiciona hospedagem de código -fonte, ambientes de desenvolvedor (GitsPaces) e registros de artefatos; Fornecendo às equipes uma plataforma de DevOps de código aberto de ponta a ponta.

O objetivo é que o arnês eventualmente esteja em plena paridade com o drone em termos de recursos de pipeline, permitindo que os usuários migrem perfeitamente do drone para o chicote.

Mas esperamos que isso leve algum tempo, e é por isso que tiramos um instantâneo do drone como um drone de ramificação (leitura) para que ele possa continuar o desenvolvimento.

Quanto ao arnês, o desenvolvimento está ocorrendo no ramo principal.

Para mais informações sobre o arnês, visite desenvolvedor.harness.io.

Para mais informações sobre o drone, visite drone.io.

Desenvolvimento de código aberto do arnês

Pré-requisitos

Instale a versão estável mais recente do Node e GO versão 1.20 ou superior e, em seguida, instale os programas abaixo. Verifique se o diretório do bin Gopath é adicionado ao seu caminho.

Instale o protobuf

• Verifique se você já instalou o Protobuf protoc --version
• Se sua versão for diferente da v3.21.11, o Run brew unlink protobuf
• Get v3.21.11 curl -s https://raw.githubusercontent.com/Homebrew/homebrew-core/9de8de7a533609ebfded833480c1f7c05a3448cb/Formula/protobuf.rb > /tmp/protobuf.rb
• Instale -o brew install /tmp/protobuf.rb
• Confira seu protoc --version

Instale o protoc-gener-go e o protoc-gen-go-rpc:

• Instale o protoc-gen-go v1.28.1 go install google.golang.org/protobuf/cmd/[email protected] (observe que isso instalará um binário em $ gobin

• Instale o protoc-gen-go-grpc v1.2.0 go install google.golang.org/grpc/cmd/[email protected]

$ make dep
$ make tools

Construir

O primeiro passo é construir os artefatos da interface do usuário:

$ pushd web
$ yarn install
$ yarn build
$ popd

Depois disso, você pode construir o arnês binário:

$ make build

Correr

Este projeto suporta todos os sistemas operacionais e arquiteturas suportados pela GO. Isso significa que você pode construir e executar o sistema em sua máquina; Os contêineres do Docker não são necessários para o desenvolvimento e teste local.

Para iniciar o servidor em localhost:3000 , basta executar o seguinte comando:

./gitness server .local.env

API de arnês de geração automática usada pela interface do usuário usando swagger

Certifique -se de atualizar o código do cliente autogenerado usado pela interface do usuário ao adicionar novas APIs REST.

Para regenerar o código, execute as seguintes etapas:

• Regenere Swagger com o mais recente arnês binário ./gitness swagger > web/src/services/code/swagger.yaml
• Navegue até a pasta web e execute yarn services

As mais recentes alterações da API devem agora ser refletidas no web/src/services/code/index.tsx

Executar testes de conformidade de registro

 make conformance-test

Para executar testes de conformidade com o serviço de corrida existente, use:

 make hot-conformance-test

Interface do usuário

Este projeto inclui uma interface de usuário completa para interagir com o sistema. Ao executar o aplicativo, você pode acessar a interface do usuário navegando para http://localhost:3000 no seu navegador.

Rest API

Este projeto inclui uma especificação de swagger. Quando você executa o aplicativo, você pode acessar a especificação Swagger navegando para http://localhost:3000/swagger no navegador (para YAML bruto, consulte http://localhost:3000/openapi.yaml ). Para pontos de extremidade do registro, atualmente Swagger está localizado em diferentes terminais http://localhost:3000/registry/swagger/ (para JSON bruto, ver http://localhost:3000/registry/swagger.json ). Estes serão movidos posteriormente para o principal ponto de extremidade da arrogância.

Para testes, é mais simples usar a CLI para criar um token (isso exige que o servidor de arnês seja executado):

 # LOGIN (user: admin, pw: changeit)
$ ./gitness login

# GENERATE PAT (1 YEAR VALIDITY)
$ ./gitness user pat " my-pat-uid " 2592000

O comando gera um PAT válido que recebeu acesso total como usuário. O token pode ser enviado como parte do cabeçalho Authorization com Postman ou Curl:

$ curl http://localhost:3000/api/v1/user 
-H " Authorization: Bearer $TOKEN " 

CLI

Este projeto inclui ferramentas de linha de comando muito básicas para desenvolvimento e execução do serviço. Lembre -se de que você deve iniciar o servidor antes de poder executar comandos.

Para uma lista completa de operações suportadas, consulte

$ ./gitness --help

Contribuindo

Consulte Contribuindo.md

Licença

Licença Apache 2.0, consulte a licença.