Skip to content

Commit a525056

Browse files
lmfarley10JBAnderson5
authored andcommitted
Added Initial Draft of Readme, Removed Unnecessary Directories
1 parent e7ecae2 commit a525056

File tree

196 files changed

+52
-15569
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

196 files changed

+52
-15569
lines changed

.gitignore

Lines changed: 9 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -100,33 +100,6 @@ clientApp/autoprompt/semantic_suggest_runbook.md
100100
# File with reference to orahub repo
101101
deployment-docs/mkdocs.yml
102102

103-
# Reference to api gateway
104-
# deployment-docs/docs/deployment/adw_private.md # cleaned up sensitive info
105-
106-
# Reference to idcs discovery url
107-
#deployment-docs/docs/deployment/business_api_gateway.md # cleaned up/masked sensitive data
108-
109-
# Reference to oda instance
110-
# deployment-docs/docs/deployment/business_idcs.md # cleaned/masked data
111-
112-
# Reference to oracle redis
113-
# deployment-docs/docs/deployment/nl2sql_engine.md # removed sensitive data. There are a lot of references to websocket... maybe we can remove this in the near future
114-
115-
# Reference to API GW url
116-
# deployment-docs/docs/deployment/oda.md # masked sensitive data
117-
118-
# Reference to OCI tenancy
119-
# deployment-docs/docs/deployment/trust-service.c.md # cleaned sensitive data. There are a couple references to artifactory here
120-
# deployment-docs/docs/deployment/trust-service.md # cleaned
121-
122-
# Reference to IDCS/API GW
123-
# deployment-docs/docs/deployment/trust-ui.md
124-
# deployment-docs/docs/deployment/validation.md # cleaned
125-
# deployment-docs/docs/deployment/VBCS.md # masked
126-
127-
# ips
128-
# /deployment-docs/docs/rest/nl2sql-trust/installation.md # masked ips
129-
130103
# Reference to OCIDs
131104
/deployment-docs/Finetune-DAC/finetune-dac-python.py
132105

@@ -155,7 +128,7 @@ deployment-docs/mkdocs.yml
155128

156129
# Adding entire rest trust directory for now, since there's a dependency on dotmap
157130
# can maybe add delta review for next release
158-
/rest/
131+
rest/
159132

160133
# Random IPs
161134
/rest/nl2sql-trust/conf/dev_trust_config.json
@@ -263,6 +236,14 @@ deployment-docs/mkdocs.yml
263236
# tenancy namespace
264237
/scripts/oci
265238

239+
# Hiding terraform for now
240+
terraform/
241+
242+
# Hiding sqlGenApp (used for finetuning)
243+
sqlGenApp/
244+
245+
scripts/
246+
266247
# Reference to tenancy
267248
/terraform/cloud-init/nl_engine_cloud_init.yml
268249
terraform/cloud-init/trust-cloud-init.yml

.ignore

Lines changed: 0 additions & 5 deletions
This file was deleted.

README-old.md

Lines changed: 0 additions & 179 deletions
This file was deleted.

README.md

Lines changed: 43 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,56 @@
1-
# TITLE
1+
# AskData NL2SQL Engine
22

33
[![License: UPL](https://img.shields.io/badge/license-UPL-green)](https://img.shields.io/badge/license-UPL-green) [![Quality gate](https://sonarcloud.io/api/project_badges/quality_gate?project=oracle-devrel_test)](https://sonarcloud.io/dashboard?id=oracle-devrel_test)
44

5-
## THIS IS A NEW, BLANK REPO THAT IS NOT READY FOR USE YET. PLEASE CHECK BACK SOON!
6-
75
## Introduction
8-
MISSING
6+
7+
[Introduction](deployment-docs/docs/deployment/introduction.md)
98

109
## Getting Started
11-
MISSING
10+
Start with familiarizing yourself with the [Architecture](deployment-docs/docs/deployment/architecture.md) & [Introduction](deployment-docs/docs/deployment/introduction.md)
11+
12+
For policies see [Defining Policies](deployment-docs/docs/deployment/generic.md)
13+
14+
The CIS Landing Zone is optional but helps with providing a sandbox environment with best practices
15+
[Deploy CIS LZ](deployment-docs/docs/deployment/landing_zone.md)
1216

1317
### Prerequisites
14-
MISSING
18+
This solution assumes you have access to an OCI tenancy with the admin ability to provision the following resources:
19+
- VBCS
20+
- [Deploy VBCS](deployment-docs/docs/deployment/VBCS.md)
21+
- ODA
22+
- [Deploy ODA](deployment-docs/docs/deployment/oda.md)
23+
- IAM Confidential App
24+
- [Deploy IAM App](deployment-docs/docs/deployment/business_idcs.md)
25+
- Vault
26+
- [Deploy Vault](deployment-docs/docs/deployment/vault.md)
27+
- API Gateway
28+
- [Deploy API Gateway](deployment-docs/docs/deployment/business_api_gateway.md)
29+
- Business (client) ADW database
30+
- [Deploy Database](deployment-docs/docs/deployment/database.md)
31+
- Trust ADB database
32+
- [Deploy Database](deployment-docs/docs/deployment/database.md)
33+
- Redis Cache
34+
- VCN
35+
- Two VMs, one for engine in private sn and one bastion/jump host
36+
- [Deploy Engine Documentation](deployment-docs/docs/deployment/nl2sql_engine.md)
37+
38+
## Deployment Steps
39+
40+
1. Configure Business App
41+
- Configure Business DB
42+
- Configure Trust DB
43+
2. Configure IDCS App
44+
3. Configure API Gateway
45+
4. Configure ODA Skills
46+
5. Configure VB Apps
1547

1648
## Notes/Issues
17-
MISSING
49+
50+
See [Troubleshooting](deployment-docs/docs/deployment/architecture.md)
51+
52+
This first release is focused on deploying the NL Engine/ClientApp for the business user. The Trust Framework plans to be added next release. However, documentation is available under [Deployment](deployment-docs/docs/deployment/)
53+
if you'd like to get familiar. All documentation related to apex & trust service would be for the trust framework.
1854

1955
## URLs
2056
* Nothing at this time

deployment-docs/.pages

Lines changed: 0 additions & 5 deletions
This file was deleted.

deployment-docs/README

Lines changed: 0 additions & 7 deletions
This file was deleted.

deployment-docs/docs/index.md

Lines changed: 0 additions & 17 deletions
This file was deleted.

0 commit comments

Comments
 (0)