Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sadok-f/docker-secrets

Simple PHP library to read docker secrets.
https://github.com/sadok-f/docker-secrets

docker docker-secret docker-secrets php php-library swarm

Last synced: 24 days ago
JSON representation

Simple PHP library to read docker secrets.

Awesome Lists containing this project

README

        


Build Status
Code Climate

# Docker Secrets

A simple PHP library to read [docker secrets](https://docs.docker.com/engine/swarm/secrets/) from a Swarm cluster.

# Installation

```bash
composer require sadok-f/docker-secrets
```

# Usage

### Read All

```php
$dockerSecrets = new DockerSecrets\Reader\SecretsReader();
$allSecrets = $dockerSecrets->readAll();
```
return:
```
Array
(
[my_secret_data_1] => testSecretDataContent1
[my_secret_data_2] => testSecretDataContent2
)
```

### Read a single secret

```php
$dockerSecrets = new DockerSecrets\Reader\SecretsReader();
$dockerSecrets->read('my_secret');
```

### Custom Location
The default location for secrets folder is to `/run/secrets/` in Linux containers.
if you're using Docker 17.06 and higher with custom location you can use the library like this example:

```php
$dockerSecrets = new DockerSecrets\Reader\SecretsReader('/var/myCustomLocation');
$dockerSecrets->read('my_secret');
```

### Read secrets in Windows containers

```php
$dockerSecrets = new DockerSecrets\Reader\SecretsReader('C:\ProgramData\Docker\secrets');
$dockerSecrets->read('my_secret');
```

# PHPUnit

```bash
./vendor/bin/phpunit
```