README.md

👮 Passport

Person Identifier as a Service — your personal user tracker and auth service.

Roadmap

• v1: MVP
  • Someday, 20xx
  • Main concepts and working prototype.
• v2: Notification
  • Sometime, 20xx
  • Notification center.
• v3: Authentication
  • Somehow, 20xx
  • Authentication center.

Quick start

Requirements:

• Docker 17.09.0-ce or above
• Docker Compose 1.16.1 or above
• Go 1.9.2 or above
• GNU Make 3.81 or above

$ make up status

       Name                     Command               State                                  Ports
----------------------------------------------------------------------------------------------------------------------------------
passport_db_1        docker-entrypoint.sh postgres    Up      0.0.0.0:5432->5432/tcp
passport_server_1    /bin/sh -c envsubst '$SERV ...   Up      80/tcp, 0.0.0.0:80->8080/tcp
passport_service_1   passport run --with-profil ...   Up      0.0.0.0:8080->80/tcp, 0.0.0.0:8090->8090/tcp, 0.0.0.0:8091->8091/tcp

Specification

API

You can find API specification here. Also, we recommend using Insomnia HTTP client to work with the API - you can import data for it from the file.

CLI

Service command-line interface

$ passport --help
Passport

Usage:
  passport [command]

Available Commands:
  completion  Print Bash or Zsh completion
  help        Help about any command
  migrate     Apply database migration
  run         Start HTTP server
  version     Show application version

Flags:
  -h, --help   help for passport

Use "passport [command] --help" for more information about a command.

Bash and Zsh completions

You can find completion files here or build your own using these commands

$ passport completion bash > /path/to/bash_completion.d/passport.sh
$ passport completion zsh  > /path/to/zsh-completions/_passport.zsh

Installation

Brew

$ brew install kamilsk/tap/passport

Binary

$ export REQ_VER=1.0.0  # all available versions are on https://github.com/kamilsk/passport/releases
$ export REQ_OS=Linux   # macOS and Windows are also available
$ export REQ_ARCH=64bit # 32bit is also available
$ # wget -q -O passport.tar.gz
$ curl -sL -o passport.tar.gz \
       https://github.com/kamilsk/passport/releases/download/"${REQ_VER}/passport_${REQ_VER}_${REQ_OS}-${REQ_ARCH}".tar.gz
$ tar xf passport.tar.gz -C "${GOPATH}"/bin/ && rm passport.tar.gz

Docker Hub

$ docker pull kamilsk/passport:1.x

From source code

$ egg github.com/kamilsk/passport@^1.0.0 -- make test install
$ # or use mirror
$ egg bitbucket.org/kamilsk/passport@^1.0.0 -- make test install

egg¹ is an extended go get.

Update

This application is in a state of MVP and under active development. SemVer is used for releases, and you can easily be updated within minor versions, but major versions can be not BC-safe.

¹ The project is still in prototyping. ↩

---

made with ❤️ by OctoLab