|
22 | 22 | - [Deployment Features](#deployment-features) |
23 | 23 | - [Roadmap](#roadmap) |
24 | 24 | - [Setup](#setup) |
25 | | - - [Build from source](#build-from-source) |
26 | | - - [Initial Configuration](#initial-configuration) |
27 | | - - [Start Service](#start-service) |
28 | | - - [Loading Apps](#loading-apps) |
29 | 25 | - [Documentation](#documentation) |
30 | 26 | - [Getting help](#getting-help) |
31 | 27 | - [Contributing](#contributing) |
32 | 28 |
|
33 | 29 | ## Overview |
34 | 30 |
|
35 | | -OpenRun is an Apache-2.0 licensed project building an open source alternative to Google Cloud Run and AWS App Runner. OpenRun allows you to deploy containerized apps. OpenRun is cross-platform (Linux/Windows/OSX) and provides a GitOps workflow for managing web apps. |
| 31 | +OpenRun is an Apache-2.0 licensed open source alternative to Google Cloud Run and AWS App Runner. OpenRun makes it easy to declaratively deploy applications built in frameworks like Streamlit/Gradio/FastHTML/NiceGUI etc. |
36 | 32 |
|
37 | | -OpenRun apps are deployed directly from the git repo, no build step required. For example, OpenRun can be used to deploy Streamlit/Gradio/NiceGUI/FastHTML apps, adding OAuth/OIDC/SAML based authentication for access control across a team. |
| 33 | +OpenRun provides **declarative** GitOps based app deployment, OAuth/OIDC/SAML access controls, TLS certs & secrets management. OpenRun is built for teams to easily deploy internal tools, with full RBAC support. OpenRun apps are deployed directly from the git repo, no build step required. OpenRun scales idles apps down to zero and supports atomic updates across multiple apps. |
38 | 34 |
|
39 | 35 | This repo hosts the source code for OpenRun. The source for the documentation site [openrun.dev](https://openrun.dev) is in the [docs](https://github.com/openrundev/docs) repo. App specifications, which are templates to create apps, are defined in the [appspecs](https://github.com/openrundev/appspecs) repo. Sample apps are in the [apps](https://github.com/openrundev/apps) repo. |
40 | 36 |
|
@@ -88,12 +84,10 @@ The feature roadmap for OpenRun is: |
88 | 84 |
|
89 | 85 | ### Certs and Default password |
90 | 86 |
|
91 | | -OpenRun manages TLS cert using LetsEncrypt for prod environments. For dev environment, it is recommended to install [mkcert](https://github.com/FiloSottile/mkcert). OpenRun will automatically create local certs using mkcert if it is present. Install mkcert and run `mkcert -install` before starting OpenRun server. Installing OpenRun using brew will automatically install mkcert. |
| 87 | +OpenRun manages TLS cert using LetsEncrypt for prod environments. For dev environment, OpenRun uses [mkcert](https://github.com/FiloSottile/mkcert) for local certs. Installing OpenRun using brew will automatically install mkcert. |
92 | 88 |
|
93 | 89 | For container based apps, Docker or Podman or Orbstack should be installed and running on the machine. OpenRun automatically detects the container manager to use. |
94 | 90 |
|
95 | | -OpenRun creates an `admin` user account as teh system auth for accessing apps. A random password is generated for this account during initial OpenRun server installation. Note down this password for accessing apps if using system auth. |
96 | | - |
97 | 91 | ### Install OpenRun On OSX/Linux |
98 | 92 |
|
99 | 93 | To install on OSX/Linux, run |
@@ -135,7 +129,7 @@ openrun apply --approve github.com/openrundev/openrun/examples/utils.star |
135 | 129 | To schedule a background sync, which automatically applies the latest app config, run |
136 | 130 |
|
137 | 131 | ``` |
138 | | -openrun sync schedule --approve github.com/openrundev/openrun/examples/utils.star |
| 132 | +openrun sync schedule --approve --promote github.com/openrundev/openrun/examples/utils.star |
139 | 133 | ``` |
140 | 134 |
|
141 | 135 | To install apps using the CLI (imperative mode), run |
@@ -210,6 +204,4 @@ Please use [Github Discussions](https://github.com/openrundev/openrun/discussion |
210 | 204 |
|
211 | 205 | ## Contributing |
212 | 206 |
|
213 | | -PRs welcome for bug fixes. For feature enhancements, please first file a ticket with the `feature` label and discuss the change before working on the code changes. |
214 | | - |
215 | | -The Google [go style guide](https://google.github.io/styleguide/go/guide) is used for OpenRun. For application behavior related fixes, refer the [app unit test cases](https://github.com/openrundev/openrun/tree/main/internal/app/tests). Those test run as part of regular unit tests `go test ./...`. For API related changes, OpenRun uses the [commander-cli](https://github.com/commander-cli/commander) library for [automated CLI tests](https://github.com/openrundev/openrun/tree/main/tests). To run the CLI test, run `gmake test` from the openrun home directory. |
| 207 | +PRs welcome for bug fixes and enhancements. For application behavior related fixes, refer the [app unit test cases](https://github.com/openrundev/openrun/tree/main/internal/app/tests). Those test run as part of regular unit tests `go test ./...`. For API related changes, OpenRun uses the [commander-cli](https://github.com/commander-cli/commander) library for [automated CLI tests](https://github.com/openrundev/openrun/tree/main/tests). To run the CLI test, run `gmake test` from the openrun home directory. |
0 commit comments