Skip to content

Commit

Permalink
docs: apply pre-commit formatting
Browse files Browse the repository at this point in the history
  • Loading branch information
jakuboskera committed Jun 2, 2022
1 parent 48293f4 commit ee91fcd
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 29 deletions.
62 changes: 35 additions & 27 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,20 @@
<a href="https://opensource.org/licenses/Apache-2.0"><img alt="jakuboskera" src="https://img.shields.io/badge/License-Apache%202.0-blue.svg"></a>
</div>

Guestbook is a simple cloud-native web application which allows visitors to leave a public comment without creating a user account.
Guestbook is a simple cloud-native web application which allows visitors to
leave a public comment without creating a user account.

Application uses [MVC architecture](https://www.giacomodebidda.com/posts/mvc-pattern-in-python-introduction-and-basicmodel/), which is widely used software architectural pattern in GUI-based applications.
Application uses
[MVC architecture](https://www.giacomodebidda.com/posts/mvc-pattern-in-python-introduction-and-basicmodel/),
which is widely used software architectural pattern in GUI-based applications.

This application among other things, contains these endpoints:
- **API** (for interaction without UI) - [python-restx/flask-restx](https://github.com/python-restx/flask-restx),
- **Prometheus metrics** (for observability) - [rycus86/prometheus_flask_exporter](https://github.com/rycus86/prometheus_flask_exporter),
- **Health** (health of a application) - [ateliedocodigo/py-healthcheck](https://github.com/ateliedocodigo/py-healthcheck).


Live demo of Guestbook application is deployed in [Heroku](http://heroku.com) 🚀, **`public comments Welcome`**!🤗:
Live demo of Guestbook application is deployed in
[Heroku](http://heroku.com) 🚀, **`public comments Welcome`**!🤗:

<p align="center">
<b>https://guestbook.jakuboskera.dev</b>
Expand All @@ -41,20 +44,24 @@ Live demo of Guestbook application is deployed in [Heroku](http://heroku.com)
- [🚀 Install](#-install-2)
- [🧹 Cleanup](#-cleanup-2)


## 🏁 Get started

1. Clone this repo
```console
$ git clone git@github.com:jakuboskera/guestbook.git

```bash
git clone git@github.com:jakuboskera/guestbook.git
```

1. Navigate to a folder `guestbook`
```console
$ cd guestbook

```bash
cd guestbook
```

1. Issue `make` command to see available targets, which you can use
```console
$ make

```bash
make
```
## 🛠 Used technologies

Expand All @@ -69,19 +76,19 @@ Live demo of Guestbook application is deployed in [Heroku](http://heroku.com)

### 🚀 Install

```console
$ make docker-run
```bash
make docker-run
```

### 🧹 Cleanup

```console
$ make docker-cleanup
```bash
make docker-cleanup
```

## 🎉 Run in Kubernetes

Using Helm chart `guestbook` from Helm repository https://jakuboskera.github.io/charts.
Using Helm chart `guestbook` from Helm repository <https://jakuboskera.github.io/charts>.

### Using Helm
#### ⚠️ Prerequisites
Expand All @@ -90,13 +97,13 @@ Using Helm chart `guestbook` from Helm repository https://jakuboskera.github.io/

#### 🚀 Install

```console
$ make helm-install
```bash
make helm-install
```
#### 🧹 Cleanup

```console
$ make helm-cleanup
```bash
make helm-cleanup
```

### Using skaffold and Helm
Expand All @@ -112,18 +119,19 @@ Ideal for local Kubernetes development.

Build, tag and deploy artifacts via Helm chart using skaffold.yaml

```console
$ make skaffold-run
```bash
make skaffold-run
```

Build, tag and deploy artifacts via Helm chart using skaffold.yaml, make port-forward to containers and write logs of containers to stdout
Build, tag and deploy artifacts via Helm chart using skaffold.yaml,
make port-forward to containers and write logs of containers to stdout

```console
$ make skaffold-dev
```bash
make skaffold-dev
```

#### 🧹 Cleanup

```console
$ make skaffold-cleanup
```bash
make skaffold-cleanup
```
5 changes: 3 additions & 2 deletions TODO.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,9 @@
# TODO

## Contributing

- [ ] [some-rules for contributors](https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors)
- [ ] <https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors>

## Code of conduct

- [ ] https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project
- [ ] <https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/adding-a-code-of-conduct-to-your-project>

0 comments on commit ee91fcd

Please sign in to comment.