Skip to content

Commit 00ab75f

Browse files
committed
Add an initial README
1 parent bc1d536 commit 00ab75f

File tree

1 file changed

+56
-0
lines changed

1 file changed

+56
-0
lines changed

README.md

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
# feature-branch-preview CircleCI Orb
2+
3+
[feature-branch-preview](https://circleci.com/orbs/registry/orb/nebulab/feature-branch-preview)
4+
5+
This repository just tracks code changes of our feature branch preview Orb,
6+
which is already public under CircleCi but there's no easy way to track
7+
changes between versions.
8+
9+
## Description
10+
11+
An Orb that can be used to connect via SSH to a remote server running a Docker
12+
daemon to spin up containers that serve preview apps with code taken from
13+
GitHub PRs.
14+
15+
The link of the newly created app will be posted in your PR, into the
16+
Deployments section.
17+
18+
## Usage
19+
20+
Add the following to your CircleCI configuration:
21+
22+
```
23+
version: 2.1
24+
orbs:
25+
feature-branch: nebulab/feature-branch-preview
26+
workflows:
27+
cool-workflow:
28+
jobs:
29+
- feature-branch/preview:
30+
domain: <domain-for-preview-apps>
31+
github_repo: <your-github-repository>
32+
github_token: <your-gh-auth-token>
33+
letsencrypt_email: <email-for-ssl-cert>
34+
server: <docker-server-to-run-containers>
35+
user: <docker-server-user>
36+
```
37+
38+
## Contributing
39+
40+
Bug reports and pull requests are welcome!
41+
42+
## License
43+
44+
feature-branch-preview is copyright © 2019 [Nebulab](http://nebulab.it/). It is
45+
free software, and may be redistributed under the terms specified in the
46+
[CircleCI Orbs License](https://circleci.com/orbs/registry/licensing).
47+
48+
## About
49+
50+
![Nebulab](http://nebulab.it/assets/images/public/logo.svg)
51+
52+
feature-branch-preview is funded and maintained by the [Nebulab](http://nebulab.it/)
53+
team.
54+
55+
We firmly believe in the power of open-source. [Contact us](http://nebulab.it/contact-us/)
56+
if you like our work and you need help with your project design or development.

0 commit comments

Comments
 (0)