Identity

Identity is a scalable and decentralized microservice for user identity management.

Prerequisites

NATS Server with JetStream: Refer to the official NATS website for installation instructions.

Dependency on NATS with JetStream

This project relies on NATS Server with JetStream functionality for its operations. Ensure that you have NATS Server with JetStream installed and running before using this project.

For installation instructions and details about NATS Server with JetStream, please refer to the official NATS website (https://nats.io).

Installation

You can install Identity using one of the following methods:

Binary

1. Clone the repository, navigate to the project directory, build, and install the binary using the following command:

   # clone the repository
   git clone https://github.com/mirror520/identity.git
   
   # navigate to the project directory
   cd identity
   
   # build and install
   go build -o $GOPATH/bin/identity cmd/main.go

2. Copy the config.yaml file to the working directory. You can find an example configuration file in the project repository.

3. Set the necessary environment variables, such as IDENTITY_PATH and IDENTITY_HTTP_PORT, if required.

4. Run the installed binary to start the Identity microservice:

   identity

Docker

1. Make sure you have Docker installed and running on your system.

2. Run the following command to start the Identity microservice using Docker:

3. Copy the config.yaml file to the working directory. You can find an example configuration file in the project repository.

   docker run -d -p 8080:8080 mirror770109/identity:latest

   This command starts the Identity microservice in a Docker container, binds it to port 8080, and sets the IDENTITY_PATH and IDENTITY_HTTP_PORT environment variables. It also mounts the config.yaml file into the container at /root/.identity/config.yaml.

Helm Chart

1. Install Helm on your Kubernetes cluster if you haven't already.

2. Add the Helm repository:

   helm repo add mirror520 https://mirror520.github.io/charts
   helm repo update

3. Create a secrets.yaml file and manually inject your secrets into it.

4. Install the Identity chart with the provided values.yaml file:

   helm install identity mirror520/identity --values values.yaml

License

This project is licensed under the MIT License.