Skip to content

Commit e62a4a9

Browse files
authored
Merge pull request #19 from EJOOSTEROP/documentation_update
readme: Pull docker from GitHub
2 parents a3bbed2 + 229053d commit e62a4a9

File tree

1 file changed

+12
-8
lines changed

1 file changed

+12
-8
lines changed

readme.md

+12-8
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ Have [Docker Desktop][DockerDesktop-url] installed.
141141
### Installation
142142

143143
In order to create the docker container you can do the following:
144-
144+
<!--
145145
1. Clone this GIT repo:
146146
```sh
147147
git clone https://github.com/EJOOSTEROP/mimodast.git
@@ -153,15 +153,21 @@ In order to create the docker container you can do the following:
153153
```docker
154154
docker create -p5005:5000 -p8093:8088 -p8085:8080 -p8094:8089 -p8095:8090 -p8096:8091 --name mimodast mimodast
155155
```
156-
2. Optionally (required for the [European Gas Inventory][GIEAPI-url] dataset) copy a `.env` file containing the <a href="#api-key">API key</a> as explained below:
156+
-->
157+
1. Create a container from the published docker image:
158+
```docker
159+
docker create -p8093:8088 -p8085:8080 -p8094:8089 --name mimodast ghcr.io/ejoosterop/mimodast
160+
```
161+
2. Optionally (required for the [European Gas Inventory][GIEAPI-url] dataset; this can safely be done at a later stage) copy a `.env` file containing the <a href="#api-key">API key</a> as explained below:
157162
```docker
158163
docker cp .env mimodast:/project/mimodast/.env
159164
```
160-
2. Start the container.
165+
2. Start the container (using the Docker Desktop UI or command line).
161166
2. For starters:
162-
- Open the docker container terminal and peruse the meltano.yml file and other files/folders at `project\mimodast\`.
167+
- Open the docker container terminal and peruse the meltano.yml file and other files/folders at `/project/mimodast/`.
163168
- Navigate to localhost:8085 to see the Airflow orhestrator (incl scheduler) interface. Use admin/admin as username/password.
164169
- Navigate to localhost:8093 to see the Superset dashboard. Use admin/admin as username/password.
170+
- Navigate to localhost:8094 to see data pipeline documentation (from dbt).
165171
- NOTE: allow for some time (~1 minute) for the container to start up all processes. On first startup wait for the completion of the first run of the USGS pipeline before reviewing Superset.
166172
167173
@@ -174,7 +180,7 @@ The image contains ELT pipelines for two data sets. The [USGS Earthquake][USGSEa
174180
175181
For the [GIE Gas Inventory][GIEAPI-url] dataset an API key is required. Create a free and immediate [GIE account][GIEAccount-url] to obtain the key.
176182
177-
This key needs to be available as an environment variable (ENV_GIE_XKEY) in the Docker container (it is referenced in the `meltano.yml` configuration file). One way to accomplish this is by creating a `.env` file in the `/projet/mimodast/` folder containing:
183+
This key needs to be available as an environment variable (ENV_GIE_XKEY) in the Docker container (it is referenced in the `meltano.yml` configuration file) in order to run the GIE pipelines. One way to accomplish this is by creating a `.env` file in the `/projet/mimodast/` folder containing:
178184
>`ENV_GIE_XKEY="YOUR-API-KEY"`
179185
180186
<p align="right">(<a href="#readme-top">back to top</a>)</p>
@@ -395,15 +401,13 @@ The following differences are noteworthy:
395401
<!-- ROADMAP -->
396402
## Roadmap
397403

404+
<!--
398405
- [ ] Include [Great Expectations][GreatExpectations-url] for data quality purposes.
399406
- [ ] Add a dbt model using [PRQL][PRQL-url] language instead of SQL.
400407
- [ ] Add a metadata framework like Amundsen, OpenLineage or similar.
401-
402-
<!--
403408
- [ ] Feature 3
404409
- [ ] Nested Feature
405410
-->
406-
407411
See the [open issues](https://github.com/EJOOSTEROP/mimodast/issues) for a full list of proposed features and known issues.
408412

409413
<p align="right">(<a href="#readme-top">back to top</a>)</p>

0 commit comments

Comments
 (0)