Skip to content

Commit c777369

Browse files
authored
Update README (#18)
1 parent a35296b commit c777369

File tree

1 file changed

+24
-57
lines changed

1 file changed

+24
-57
lines changed

README.md

Lines changed: 24 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,13 @@
1-
# Welcome to the Cluster Connect Gateway
1+
# Cluster Connect Gateway
2+
3+
## Table of Contents
4+
5+
- [Overview](#overview)
6+
- [Get Started](#get-started)
7+
- [Develop](#develop)
8+
- [Contribute](#contribute)
9+
- [Community and Support](#community-and-support)
10+
- [License](#license)
211

312
## Overview
413

@@ -13,70 +22,25 @@ Key features include:
1322
- **Cluster API integration**: Seamlessly work with Cluster API.
1423
- **Intel Open Edge Platform integration**: Seamlessly work with Intel® Open Edge Platform.
1524

16-
## Get Started
17-
18-
Install Cluster Connect Gateway operator.
19-
20-
```
21-
helm install -n orch-system --create-namespace deployment/charts/cluster-connect-gateway-crd
22-
helm install -n orch-system --create-namespace deployment/charts/cluster-connect-gateway
23-
```
24-
25-
Create a ClusterConnect for the edge cluster.
26-
27-
```
28-
cat > example.yaml << "EOF"
29-
apiVersion: cluster.edge-orchestrator.intel.com/v1alpha1
30-
kind: ClusterConnect
31-
metadata:
32-
name: example-cluster-connect
33-
spec:
34-
serverCertRef:
35-
apiVersion: v1
36-
kind: Secret
37-
name: example-cluster-ca
38-
namespace: default
39-
clientCertRef:
40-
apiVersion: v1
41-
kind: Secret
42-
name: example-cluster-cca
43-
namespace: default
44-
45-
kubectl apply -f example.yaml
46-
```
47-
48-
Get connect-agent pod manifest.
49-
50-
```
51-
kubectl get clusterconnect example-cluster-connect \
52-
-o go-template="{{ if .status.ready }}{{ .status.agentManifest }}{{ end }}" \
53-
> connect-agent.yaml
54-
```
25+
Read more about Cluster Connect Gateway in the [Edge Cluster Orchestrator Developer Guide][cluster-orch-dev-guide-url] for internals and software architecture.
5526

56-
Deploy connect-agent to the edge cluster.
57-
58-
```
59-
kubectl apply -f connect-agent.yaml
60-
```
27+
## Get Started
6128

62-
Another way to try out Cluster Connect Gateway is by using the Intel® Open Edge Platform. Refer to the [Documentation](https://literate-adventure-7vjeyem.pages.github.io/edge_orchestrator/user_guide_main/content/user_guide/get_started_guide/gsg_content.html) to get started with Intel® Open Edge Platform.
29+
The recommended way to try out the Cluster Connect Gateway is by using the Edge Orchestrator.
30+
Refer to the [Getting Started Guide](https://docs.openedgeplatform.intel.com/edge-manage-docs/main/user_guide/get_started_guide/index.html) to get started with the Edge Orchestrator.
6331

6432
## Develop
6533

66-
If you are interested in contributing to the development of Cluster Connect Gateway, follow these steps to get started:
34+
If you are interested in contributing to the development of Cluster Connect Gateway, you will need an environment where you can use it to create and delete clusters.
6735

68-
```
69-
make run-e2e-and-keep
70-
```
71-
72-
This command creates a KinD cluster, deploy cert-manager, Cluster API operator and providers, and build and deploy Cluster Connect Gateway from your local repository.
73-
74-
After making changes, rebuild and deploy the updated code.
36+
The [cluster-tests](https://github.com/open-edge-platform/cluster-tests) repo provides a lightweight environment for integration testing of Cluster Connect Gateway as well as other Edge Orchestrator components related to cluster management. Clone that repo, change into the cluster-tests directory, and run:
7537

7638
```
77-
make redeploy
39+
make test
7840
```
7941

42+
This command creates a KinD cluster and deploys cert-manager, Cluster API operator, CAPI Provider for Intel, Cluster Manager, and Cluster Connect Gateway. It then creates and deletes a cluster inside a Kubernetes pod. Consult the cluster-tests [README](https://github.com/open-edge-platform/cluster-tests/blob/main/README.md) for details on how to test your code in this environment.
43+
8044
## Contribute
8145

8246
We welcome contributions from the community! To contribute, please open a pull request to have your changes reviewed and merged into the main. To learn how to contribute to the project, see the [contributor's guide](https://docs.openedgeplatform.intel.com/edge-manage-docs/main/developer_guide/contributor_guide/index.html). We encourage you to add appropriate unit tests and e2e tests if your contribution introduces a new feature.
@@ -91,10 +55,13 @@ make license
9155

9256
## Community and Support
9357

94-
To learn more about the project, its community, and governance, visit the Edge Orchestrator Community.
95-
For support, start with Troubleshooting or contact us.
58+
To learn more about the project, its community, and governance, visit the [Edge Orchestrator Community](https://docs.openedgeplatform.intel.com/edge-manage-docs/main/index.html).
59+
For support, start with [Troubleshooting](https://docs.openedgeplatform.intel.com/edge-manage-docs/main/developer_guide/troubleshooting/index.html) or contact us.
9660

9761
## License
9862

9963
Cluster Connect Gateway is licensed under [Apache 2.0 License](LICENSES/Apache-2.0.txt)
10064

65+
Last Updated Date: April 16, 2025
66+
67+
[cluster-orch-dev-guide-url]: https://docs.openedgeplatform.intel.com/edge-manage-docs/main/developer_guide/cluster_orch/index.html

0 commit comments

Comments
 (0)