Identity is a scalable and decentralized microservice for user identity management.
NATS Server with JetStream: Refer to the official NATS website for installation instructions.
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).
You can install Identity using one of the following methods:
-
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
-
Copy the
config.yaml
file to the working directory. You can find an example configuration file in the project repository. -
Set the necessary environment variables, such as
IDENTITY_PATH
andIDENTITY_HTTP_PORT
, if required. -
Run the installed binary to start the Identity microservice:
identity
-
Make sure you have Docker installed and running on your system.
-
Run the following command to start the Identity microservice using Docker:
-
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
andIDENTITY_HTTP_PORT
environment variables. It also mounts theconfig.yaml
file into the container at/root/.identity/config.yaml
.
-
Install Helm on your Kubernetes cluster if you haven't already.
-
Add the Helm repository:
helm repo add mirror520 https://mirror520.github.io/charts helm repo update
-
Create a
secrets.yaml
file and manually inject your secrets into it. -
Install the Identity chart with the provided
values.yaml
file:helm install identity mirror520/identity --values values.yaml
This project is licensed under the MIT License.