1
1
# Koku microfrontend (MFE) with Module Federation
2
2
3
- [ ![ AGPLv3] [ license-badge ]] [ license ]
4
- [ ![ Build Status] [ build-badge ]] [ build ]
3
+ [ ![ Apache 2.0] [ license-badge ]] ( https://github.com/project-koku/koku-ui-mfe/blob/main/LICENSE )
4
+ [ ![ CI Status] [ build-badge ]] ( https://github.com/project-koku/koku-ui-mfe/actions/workflows/ci.yml?query=branch%3Amain )
5
+ [ ![ codecov] [ codecov-badge ]] ( https://codecov.io/gh/project-koku/koku-ui-mfe )
5
6
6
7
React.js app for Cost Management.
7
8
8
- User interface is based on Patternfly [ ![ Patternfly] [ pf-logo ]] [ patternfly ]
9
+ User interface is based on [ Patternfly] .
9
10
10
- To submit an issue, please visit https://issues.redhat.com/projects/COST/
11
+ Submit issues in [ Jira ] .
11
12
12
13
## Requirements
14
+
13
15
* [ NodeJS v18.15+] [ nodejs ]
14
16
* [ npm v9.5+] [ npm ]
15
17
16
- ## Setup /etc/ hosts entries (do this once)
18
+ ## Setup ` hosts ` entries (do this once)
17
19
18
- Edit the /etc/hosts file and add the following entries
20
+ Edit the ` /etc/hosts ` file and add the following entries
19
21
```
20
22
127.0.0.1 prod.foo.redhat.com
21
23
127.0.0.1 stage.foo.redhat.com
@@ -27,8 +29,9 @@ sudo bash scripts/patch-etc-hosts.sh
27
29
```
28
30
29
31
## Getting Started
32
+
30
33
1 . Install requirements listed above.
31
- 2 . Setup /etc/hosts entries listed above.
34
+ 2 . Setup ` /etc/hosts ` entries listed above.
32
35
3 . Clone the repository, and open a terminal in the base of this project.
33
36
4 . Run the command ` npm install ` to install all the dependencies.
34
37
@@ -43,6 +46,7 @@ npm test
43
46
```
44
47
45
48
## Running Koku MFE against a hosted Koku API, using webpack proxy
49
+
46
50
Note that this approach currently supports the Insights stage-beta, stage-stable, prod-beta, and prod-stable environments.
47
51
48
52
1 . Start development server
@@ -63,7 +67,7 @@ https://stage.foo.redhat.com:1337/beta/staging/cost-management
63
67
64
68
### Running Koku MFE with local Cloud Services Backend
65
69
66
- See https://github.com/RedHatInsights/chrome-service-backend/blob/main/docs/cloud-services-config.md# serving-files-locally
70
+ Refer to the [ serving files locally ] [ serving -files-locally] section of cloud services config for more details
67
71
68
72
1 . Serve files locally from Cloud Services Backend repo
69
73
```
@@ -77,7 +81,7 @@ npm start:csb
77
81
78
82
### Running Koku MFE with local Koku UI
79
83
80
- See https://github.com/project- koku/koku -ui
84
+ Refer to the [ koku-ui README ] [ koku-ui-readme ] for more details
81
85
82
86
1 . Start development server in Koku MFE repo
83
87
```
@@ -91,8 +95,7 @@ npm start:mfe
91
95
92
96
### Running Koku MFE with local Koku UI and Cloud Services Backend
93
97
94
- See https://github.com/RedHatInsights/chrome-service-backend/blob/main/docs/cloud-services-config.md#serving-files-locally
95
- and https://github.com/project-koku/koku-ui
98
+ Refer to the [ serving files locally] [ serving-files-locally ] section of cloud services config and the [ koku-ui README] [ koku-ui-readme ] for more details
96
99
97
100
1 . Serve files locally from Cloud Services Backend repo
98
101
```
@@ -113,12 +116,14 @@ npm start:csb:mfe
113
116
114
117
This [ RELEASE] [ release-doc ] doc describes how to release Koku MFE to each staging environment.
115
118
116
- [ koku-readme ] : https://github.com/project-koku/koku#readme
117
- [ license-badge ] : https://img.shields.io/github/license/project-koku/koku-ui-mfe.svg?longCache=true&style=for-the-badge
118
- [ license ] : https://github.com/project-koku/koku-ui-mfe/blob/main/LICENSE
119
+ [ build-badge ] : https://github.com/project-koku/koku-ui-mfe/actions/workflows/ci.yml/badge.svg?branch=main
120
+ [ codecov-badge ] : https://codecov.io/gh/project-koku/koku-ui-mfe/graph/badge.svg?token=1hjFIy1cRe
121
+ [ Jira ] : https://issues.redhat.com/projects/COST/
122
+ [ koku-ui-readme ] : https://github.com/project-koku/koku-ui#readme
123
+ [ license-badge ] : https://img.shields.io/github/license/project-koku/koku-ui-mfe.svg?longCache=true
119
124
[ nodejs ] : https://nodejs.org/en/
125
+ [ npm ] : https://www.npmjs.com/
120
126
[ patch-etc-hosts ] : https://github.com/RedHatInsights/insights-proxy/blob/master/scripts/patch-etc-hosts.sh
121
- [ pf-logo ] : https://www.patternfly.org/v4/images/logo.4189e7eb1a0741ea2b3b51b80d33c4cb.svg
122
- [ patternfly ] : https://www.patternfly.org/
127
+ [ Patternfly ] : https://www.patternfly.org/
123
128
[ release-doc ] : https://github.com/project-koku/koku-ui-mfe/blob/main/RELEASE.md
124
- [ npm ] : https://https://www.npmjs. com/
129
+ [ serving-files-locally ] : https://github. com/RedHatInsights/chrome-service-backend/blob/main/docs/cloud-services-config.md#serving-files-locally
0 commit comments