Skip to content

Commit dcf33b6

Browse files
authored
Add a Updating the TLS certificate section (#737)
* Add a Updating the TLS certificate section * Resolve @rhondaday comments (TY) * implemented comments
1 parent a428a06 commit dcf33b6

File tree

1 file changed

+40
-18
lines changed

1 file changed

+40
-18
lines changed

docs-source/mbaas/content/setup/_index.md

Lines changed: 40 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -32,23 +32,23 @@ To start the installation, take the following steps:
3232
6. On the **Create Stack** page:
3333

3434
a. Modify the suggested name, if desired.
35-
35+
3636
b. Add a description or tags, if desired.
37-
37+
3838
c. Click **Next**.
3939

4040
7. On the **Configure variables** page, in the **Backend as a Service** section (see the following image):
4141

4242
a. Specify an application name, if desired. If not specified, a randomized value is generated. This is the name of the Parse application.
43-
43+
4444
b. Specify an application ID, if desired. If not specified, a randomized value is generated. This is the Parse `APPLICATION_ID`.
45-
45+
4646
c. Specify a server master key, if desired. If not specified, a randomized value is generated. This is the Parse `MASTER_KEY`.
47-
47+
4848
d. Change the dashboard user name, if desired. Note that this is case-sensitive.
49-
49+
5050
e. Provide a dashboard password for the dashboard user. Oracle recommends using a strong password for security purposes.
51-
51+
5252
For example:
5353

5454
![Configure variables page](../mbaas-configure-variables.png)
@@ -64,25 +64,47 @@ To start the installation, take the following steps:
6464
11. In the **Database Options** section, you can customize the database shape and the CIDR for client access. Note that you cannot access
6565
**Database Actions** if you change the network access to `PRIVATE_ENDPOINT_ACCESS`.
6666

67-
12. Once you have completed customization, click **Next**.
67+
12. Once you have completed customization, click **Next**.
6868

6969
13. The **Review** page is displayed. Check your settings and then click **Create** to create the stack and run the Terraform `apply`
70-
command to create all of the associated resources.
70+
command to create all of the associated resources.
7171

7272
You can monitor the installation in the log. Installation takes approximately 20 minutes to complete. Most of this time is spent provisioning
7373
the Kubernetes cluster, its nodes, and the database.
7474

75-
When the installation is finished, some important information is included at the end of the log. You need this information to access
75+
When the installation is finished, some important information is included at the end of the log. You need this information to access
7676
the newly created environment. For example:
7777

78+
```text
79+
kubeconfig_cmd = "oci ce cluster create-kubeconfig --cluster-id ocid1.cluster.oc1.iad.aaaaaaaatc --region us --token-version 2.0.0 --kube-endpoint PUBLIC_ENDPOINT --file $HOME/.kube/config"
80+
parse_application_id = "MYCOOLAPP001"
81+
parse_dashboard_password = <sensitive>
82+
parse_dashboard_uri = "https://1.2.3.4/parse-dashboard"
83+
parse_dashboard_user = "ADMIN"
84+
parse_endpoint = "https://1.2.3.4/parse"
85+
parse_master_key = <sensitive>
7886
```
79-
application_id = "COOLAPPV100"
80-
dashboard_password = <sensitive>
81-
dashboard_uri = "http://1.2.3.4"
82-
dashboard_user = "ADMIN"
83-
kubeconfig_cmd = "oci ce cluster create-kubeconfig --cluster-id ocid1.cluster.oc1.iad.xxx
84-
--file $HOME/.kube/config --region us-ashburn-1 --token-version 2.0.0 --kube-endpoint PUBLIC_ENDPOINT"
85-
parse_endpoint = "1.2.3.4/parse"
86-
```
87+
88+
## TLS
89+
90+
The Oracle Backend for Parse Platform is deployed with a sample self-signed certificate for Transport Layer Security (TLS). This results in an "Accept Risk" message when accessing the Parse Dashboard and the sample TLS certificate should not be used for production deployments.
91+
92+
### Updating the TLS Certificate
93+
94+
1. Ensure your Domain Name System (DNS) entry points to the IP address specified in the `parse_dashboard_uri` output.
95+
2. Obtain a new TLS certificate. In a production environment, the most common scenario is to use a public certificate that has been signed by a certificate authority.
96+
3. Create a new Kubernetes secret in the `ingress-nginx` namespace. For example:
97+
98+
```bash
99+
kubectl -n ingress-nginx create secret tls my-tls-cert --key new-tls.key --cert new-tls.crt
100+
```
101+
102+
4. Modify the service definition to reference the new Kubernetes secret by changing the `service.beta.kubernetes.io/oci-load-balancer-tls-secret` annotation in the service configuration. For example:
103+
104+
```bash
105+
kubectl patch service ingress-nginx-controller -n ingress-nginx \
106+
-p '{"metadata":{"annotations":{"service.beta.kubernetes.io/oci-load-balancer-tls-secret":"my-tls-cert"}}}' \
107+
--type=merge
108+
```
87109

88110
Next, go to the [Microsoft Azure/OCI Multicloud Installation](../azure/) page to learn how to use the newly installed environment.

0 commit comments

Comments
 (0)