Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/devnatan/docker-kotlin
Docker Engine Remote API client
https://github.com/devnatan/docker-kotlin
api client docker docker-kotlin engine java jvm kotlin multiplatform
Last synced: about 2 months ago
JSON representation
Docker Engine Remote API client
- Host: GitHub
- URL: https://github.com/devnatan/docker-kotlin
- Owner: DevNatan
- License: mit
- Created: 2021-08-05T02:51:17.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-15T04:31:21.000Z (4 months ago)
- Last Synced: 2024-10-28T04:10:39.641Z (about 2 months ago)
- Topics: api, client, docker, docker-kotlin, engine, java, jvm, kotlin, multiplatform
- Language: Kotlin
- Homepage:
- Size: 720 KB
- Stars: 22
- Watchers: 2
- Forks: 4
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Support: SUPPORTED_ENDPOINTS.md
Awesome Lists containing this project
README
# docker-kotlin
[](https://github.com/DevNatan/docker-kotlin/actions/workflows/build.yml)
[](https://github.com/DevNatan/docker-kotlin/actions/workflows/integration-tests.yml)
docker-kotlin allows you to interact with the Docker Engine Remote API in a simplified and fast way.
* [Installation](#installation)
* [Basic Usage](#basic-usage)
* [Supported Endpoints](SUPPORTED_ENDPOINTS.md)
## Installation
```kotlin
repositories {
mavenCentral()
}
dependencies {
implementation("me.devnatan:docker-kotlin:0.6.0")
}
```
For JVM users, use the Docker client JVM artifact
```groovy
implementation 'me.devnatan:docker-kotlin-jvm:0.6.0'
```
## Basic Usage
Use `DockerKotlin.create()` to create a new Docker client instance with the default settings, default settings are based on the
current platform or environment variables, e.g.: socket path will be set to [`DOCKER_HOST`](https://docs.docker.com/compose/environment-variables/envvars/#docker_host)
if present otherwise `unix://var/run/docker.sock` if the current platform is Unix-like.
```kotlin
val client = DockerClient.create()
```
To change the default configuration properties use `DockerClientConfig` and `DockerClient` overload.
```kotlin
val client = DockerClient {
// this: DockerClientConfigBuilder
}
```
##### Get System Information
```kotlin
val version: SystemVersion = client.system.version()
```
##### Create and start a Container with explicit port bindings
```kotlin
val containerId = client.containers.create("busybox:latest") {
// Only if your container doesn't already expose this port
exposedPort(80u)
hostConfig {
portBindings(80u) {
add(PortBinding("0.0.0.0", 8080u))
}
}
}
client.containers.start(containerId)
```
##### Create and start a Container with auto-assigned port bindings
```kotlin
val containerId = client.containers.create("busybox:latest") {
// Only if your container doesn't already expose this port
exposedPort(80u)
hostConfig {
portBindings(80u)
}
}
client.containers.start(containerId)
// Inspect the container to retrieve the auto-assigned ports
val container = testClient.containers.inspect(id)
val ports = container.networkSettings.ports
```
##### List All Containers
```kotlin
val containers: List = client.containers.list()
```
##### Create a new Network
```kotlin
val networkId: String = client.networks.create {
name = "octopus-net"
driver = "overlay"
}
```
##### Stream Container Logs
```kotlin
val logs: Flow = client.containers.logs("floral-fury") {
stderr = true
stdout = true
}
logs.onStart { /* streaming started */ }
.onCompletion { /* streaming finished */ }
.catch { /* something went wrong */ }
.collect { log -> /* do something with each log */ }
```
## License
docker-kotlin is licensed under the MIT license.