Skip to content

Commit c640222

Browse files
authored
Merge pull request #26 from joagonzalez/feature/versioning
#1 #25 fix rtd build and k8s deployment ready
2 parents b958647 + 140e306 commit c640222

File tree

3 files changed

+21
-15
lines changed

3 files changed

+21
-15
lines changed

README.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
![Python](https://img.shields.io/badge/python-v3.12.x-orange)
33
![Python](https://img.shields.io/badge/platform-linux-blue)
44
[![Build Status](https://github.com/joagonzalez/python-seed-v2/actions/workflows/pipeline.yml/badge.svg)](https://github.com/joagonzalez/python-seed-v2/actions/workflows/pipeline.yml)
5-
[![Documentation](https://readthedocs.org/projects/python-seed/badge/?)](https://python-seed.readthedocs.io/en/latest/)
5+
[![Documentation](https://readthedocs.org/projects/python-seed-v2/badge/?)](https://python-seed-v2.readthedocs.io/en/latest/)
66
[![Coverage Status](https://coveralls.io/repos/github/joagonzalez/python-seed-v2/badge.svg?branch=master)](https://coveralls.io/github/joagonzalez/python-seed-v2?branch=master)
77

88
---
@@ -49,16 +49,16 @@ Static documentation is generated at *docs/* folder and is deployed when a relea
4949

5050
Docs URL is published in badge in this README.
5151

52+
Once configured via the Read the Docs UI, a webhook is automatically added to the repository. This webhook listens for new merge commits to the `master` branch and triggers the documentation rebuild process by sending an HTTPS request to Read the Docs.
53+
5254
## CICD Pipeline
53-
The pipeline uses a custom docker agent with all the neccessary requirements. It also uses conditionals to fork workflow executions depending on branch naming, in this way we can achieve our goal using only one pipeline. Callback on success and on failure are used in order to send messages to a specific telegram bot.
55+
The pipeline leverages GitHub Actions, installing all required dependencies directly on the GitHub-hosted runner. Conditional steps are used to control workflow execution based on branch naming, allowing a single pipeline to handle different scenarios. Notifications on success and failure are sent to a specific Telegram bot using callbacks.
5456

5557
<img src="docs/pipelines/pipeline.png" />
5658

5759
## Build
5860
```bash
59-
make build # build api image, only for development
60-
make build-doc # build documentation image, only for development
61-
make build-github-actions-builder # build a new image to be used as CI CD pipeline builder
61+
build-images # build api image and documentation image, only for development
6262
```
6363

6464
## Run
@@ -72,7 +72,13 @@ make code-quality
7272
make test
7373
make doc # run mkdocs development server
7474
make run # run api using local uvicorn
75-
make deploy-local # deploy docker-compose stack locally
75+
```
76+
77+
To deploy the application locally on a Minikube Kubernetes cluster, use the provided Makefile command:
78+
79+
```bash
80+
# Not implemented yet
81+
make deploy-minikube # deploys the application to your local Minikube cluster
7682
```
7783

7884
### Production

docs/pipelines/pipeline.png

-98 KB
Loading

docs/requirements.txt

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
1-
mkdocs-autorefs==0.5.0
2-
mkdocstrings==0.24.0
3-
mkdocstrings-python==1.8.0
4-
markdown==3.6
5-
mkdocs==1.6.0
6-
mkdocs-material==9.5.21
7-
mdx_truly_sane_lists==1.3
8-
pymdown-extensions==10.8.1
9-
jinja2==3.1.4
1+
mkdocs-autorefs
2+
mkdocstrings
3+
mkdocstrings-python
4+
markdown
5+
mkdocs
6+
mkdocs-material
7+
mdx_truly_sane_lists
8+
pymdown-extensions
9+
jinja2

0 commit comments

Comments
 (0)