# hub-dexctl

**Repository Path**: mirrors_epam/hub-dexctl

## Basic Information

- **Project Name**: hub-dexctl
- **Description**: Command line tool to communicate with Dex API
- **Primary Language**: Unknown
- **License**: MPL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-10-24
- **Last Updated**: 2025-12-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dexctl

## Description

A command line tool which communicate with [The Dex API](https://dexidp.io/docs/api/). With help of this tool you could `create`, `update` and `delete` such dex entity like static password of static oauth2 clients.

### Usage

Values for global flags `host`, `port`, `ca-cert`, `client-cert` and `client-key` could be also read from env variables with prefix `DEX_API`

```bash
DEX_API_HOST="api.mydex.com" dexctl create password --email my@email.com --password verystrongpassword
```

## Development

### Prepare

```bash
go mod download
```

### Build

```bash
go build -o bin/$(go env GOOS)/dexctl \
    -ldflags="-s -w \
    -X 'github.com/epam/hub-dexctl/cmd.ref=$(git rev-parse --abbrev-ref HEAD)' \
    -X 'github.com/epam/hub-dexctl/cmd.commit=$(git rev-parse --short HEAD)' \
    -X 'github.com/epam/hub-dexctl/cmd.buildAt=$(date +"%Y.%m.%d %H:%M %Z")'"
```

### Run

```bash
./bin/$(go env GOOS)/dexctl
```

### Docker image

Docker image is based on distoless image [static-debian11](https://github.com/GoogleContainerTools/distroless/blob/main/base/README.md)

```bash
IMAGE_NAME="ghcr.io/epam/dexctl";
IMAGE_TAG="$(git rev-parse --short HEAD)";
docker buildx build --tag "${IMAGE_NAME}:${IMAGE_TAG}" --tag "${IMAGE_NAME}:latest" . ;
```

### Contribute

Before commit and submit pull request run next commands

```bash
go fmt github.com/epam/hub-dexctl/...
go vet github.com/epam/hub-dexctl/...
```