Skip to content

Commit

Permalink
docs: update readme (#139)
Browse files Browse the repository at this point in the history
  • Loading branch information
Thomasevano authored Oct 15, 2023
1 parent 18568d4 commit fff58dd
Showing 1 changed file with 83 additions and 24 deletions.
107 changes: 83 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,46 +1,105 @@
# VSCode Webview React
# EasyDocker

This project was bootstrapped with
* [Create React App](https://github.com/facebookincubator/create-react-app)
* [Create React App TypeScript](https://github.com/wmonk/create-react-app-typescript)
* [VSCode Extension Webview Sample](https://github.com/Microsoft/vscode-extension-samples/tree/master/webview-sample)
EasyDocker est une application qui permet de créer un fichier `docker-compose.yml` facilement via une interface graphique intuitive

[The webview API](https://code.visualstudio.com/docs/extensions/webview) allows extensions to create customizable views within VSCode. Single Page Application frameworks are perfect fit for this use case. However, to make modern JavaScript frameworks/toolchains appeal to VSCode webview API's [security best practices](https://code.visualstudio.com/docs/extensions/webview#_security) requires some knowledge of both the bundling framework you are using and how VSCode secures webview. This project aims to provide an out-of-box starter kit for Create React App and TypeScript in VSCode's webview.
## Developpement

## Development
Les commandes docker les plus importantes se trouve dans le fichier `Makefile`

Run following commands in the terminal
### Lancer le projet

```shell
yarn install --ignore-engines
yarn run build
make up
# docker compose up --build --detach
```
And then press F5, in Extension Development Host session, run `Start React Webview` command from command palette.

### Docker
### Arrêter les container

If you don't want to install nodejs and yarn, you can use docker to build the project.
```shell
make down
# docker compose down --remove-orphans
```

### Installer les dépendances Front

```shell
make install
# docker compose exec -it front yarn install --ignore-engines
```

### Build le Front

```shell
make build
# docker compose exec -it front yarn run build
```

### Lancer le Front en mode watch

```shell
make watch
# docker compose exec -it front yarn run watch-build
```

### Voir les logs

```shell
make logs:
# docker compose logs -f
```

### Logs de l'API

```shell
make up # start docker container
make install # install yarn dependencies
make watch # watch file changes and build
make api-logs
# docker compose logs -f api
```

If you want to kill your docker container, run `make down`.
### Logs du Front

# Production
```shell
make front-logs
# docker compose logs -f front
```

### Lint du Front

```shell
make front-linter
# docker compose exec -it front yarn lint
```

### Logs de la base de donnée

```shell
make database-logs
# docker compose logs -f database
```

### Ouvrir un terminal bash dans le container de l'API

```shell
make api-sh
# docker compose exec -it api sh
```

### Ouvrir un terminal bash dans le container du Front

```shell
make front-sh
# docker compose exec -it front sh
```

## Build api Docker image
### Ouvrir un terminal bash dans le container de la base de donnée

```shell
docker build -t easydocker/api -f ./api/Dockerfile ./api
make database-sh
# docker compose exec -it database sh
```

## Build front Docker image
### Lancer les tests de l'API

```shell
docker build --tag easydocker/front \
--build-arg VITE_API_URL=<API_URL> \
-f front/Dockerfile.prod ./front
make api-test
# docker compose exec -it api go test -v ./...
```

0 comments on commit fff58dd

Please sign in to comment.