Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/flarexio/identity
https://github.com/flarexio/identity
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/flarexio/identity
- Owner: flarexio
- License: mit
- Created: 2024-10-23T17:45:23.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2024-11-05T14:42:13.000Z (2 months ago)
- Last Synced: 2024-11-05T15:43:34.361Z (2 months ago)
- Language: Go
- Size: 220 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Identity [](https://drone.flarex.io/flarexio/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:
```shell
# clone the repository
git clone https://github.com/flarexio/identity.git
# navigate to the project directory
cd identity
# build and install
go build -o $GOPATH/bin/identity cmd/identity/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:
```shell
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.
```shell
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:
```shell
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:
```shell
helm install identity mirror520/identity --values values.yaml
```
## License
This project is licensed under the [MIT License](LICENSE).