https://github.com/portward/portward

Portward is an all-in-one registry authorization service
https://github.com/portward/portward

container-registry docker docker-registry docker-registry-authentication docker-registry-v2 hacktoberfest oci-distribution

Last synced: 6 months ago
JSON representation

Portward is an all-in-one registry authorization service

• Host: GitHub
• URL: https://github.com/portward/portward
• Owner: portward
• License: mit
• Created: 2023-09-20T06:19:55.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2024-11-10T14:10:31.000Z (over 1 year ago)
• Last Synced: 2024-11-10T14:37:08.997Z (over 1 year ago)
• Topics: container-registry, docker, docker-registry, docker-registry-authentication, docker-registry-v2, hacktoberfest, oci-distribution
• Language: Go
• Size: 360 KB
• Stars: 7
• Watchers: 2
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  

    

      

      

    

  

  


    Portward

  


[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/portward/portward/ci.yaml?style=flat-square)](https://github.com/portward/portward/actions/workflows/ci.yaml)

[![go.dev reference](https://img.shields.io/badge/go.dev-reference-007d9c?logo=go&logoColor=white&style=flat-square)](https://pkg.go.dev/mod/github.com/portward/portward)

[![built with nix](https://img.shields.io/badge/builtwith-nix-7d81f7?style=flat-square)](https://builtwithnix.org)

**An all-in-one registry authorization service implementing the [Docker (Distribution) Registry Auth specification](https://github.com/distribution/distribution/tree/main/docs/spec/auth).**

> [!WARNING]

> **Project is under development. Backwards compatibility is not guaranteed.**

## Quickstart

Check out the [quickstart](https://github.com/portward/quickstart/) repository for a demonstration of Portward's capabilities.

## Development

**For an optimal developer experience, it is recommended to install [Nix](https://nixos.org/download.html) and [direnv](https://direnv.net/docs/installation.html).**

### Using Dagger

Run tests:

```shell

dagger call test

```

Run linters:

```shell

dagger call lint

```

### Manual workflow

Launch dependencies:

```shell

docker compose up -d

```

Run the service

```shell

just run

```

Run tests

```shell

just test-all

```

Cleanup:

```shell

docker compose down -v

```

## License

The project is licensed under the [MIT License](LICENSE).