Skip to content

Commit ac80124

Browse files
authored
Add Readme (#6)
* chore(#5): wrote docs for basic usage of generic image and gha image * chore(#5): Added badges for build, release, and license
1 parent 2971024 commit ac80124

File tree

1 file changed

+50
-2
lines changed

1 file changed

+50
-2
lines changed

README.md

Lines changed: 50 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,50 @@
1-
# docker-temporal-dev-server
2-
Temporal.io Development Server Container Image
1+
# Temporal.io Development Server
2+
3+
[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/InfinityFlowApp/docker-temporal-dev-server/release.yml)](https://github.com/InfinityFlowApp/docker-temporal-dev-server/actions?query=branch%3Amain)
4+
[![GitHub Release](https://img.shields.io/github/v/release/InfinityFlowApp/docker-temporal-dev-server)](https://github.com/InfinityFlowApp/docker-temporal-dev-server/releases)
5+
[![GitHub License](https://img.shields.io/github/license/InfinityFlowApp/docker-temporal-dev-server)](https://github.com/InfinityFlowApp/docker-temporal-dev-server?tab=MIT-1-ov-file)
6+
7+
This repository contains Dockerfiles for setting up the Temporal.io Development Server in two variants:
8+
9+
1. Generic: A flexible configuration suitable for general purposes.
10+
2. GitHub Actions: A specialized configuration with defaults set for use in GitHub Actions workflows,
11+
optimized for testing with a predefined namespace and only exposing port 7233.
12+
13+
# Introduction
14+
15+
Temporal.io is a microservices orchestration platform for running mission-critical code at any scale.
16+
This repository provides Dockerfiles for setting up a Temporal.io development server in two distinct configurations
17+
to aid in local development and continuous integration (CI) processes.
18+
19+
# Running the Container
20+
21+
Start the container using the appropriate variant:
22+
23+
## Generic
24+
25+
```shell
26+
docker run -p 7233:7233 -p 8233:8233 ghcr.io/infinityflowapp/temporal-dev-server:<version>
27+
```
28+
29+
## GitHub Actions Service
30+
31+
Add or update the services section of your workflow
32+
33+
```yaml
34+
jobs:
35+
<job>:
36+
services:
37+
<service>:
38+
image: ghcr.io/infinityflowapp/temporal-gha-service:<version>
39+
ports:
40+
- 7233:7233
41+
```
42+
43+
Use a client pointing to your service (pseudo code)
44+
45+
```java
46+
var client = new TemporalClient("<service>:7233");
47+
```
48+
49+
# License
50+
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

0 commit comments

Comments
 (0)