Skip to content

Commit b32e3c6

Browse files
authored
Amended installation instructions (#81)
* Amended installation instruction and relaxed linting and testing workflow triggers. Signed-off-by: Michael Primeaux <[email protected]> * Minor typographic error. Signed-off-by: Michael Primeaux <[email protected]> * - Reverted linting and testing trigger globbing. Signed-off-by: Michael Primeaux <[email protected]> * - Added path globbing. Signed-off-by: Michael Primeaux <[email protected]> * - Removed path globbing. Signed-off-by: Michael Primeaux <[email protected]> * Revert "- Amended CHANGELOGs" This reverts commit e0ab178. * - Bumped chart versions. - Amended CHANGELOGs. Signed-off-by: Michael Primeaux <[email protected]> * Incremented opensearcn chart version to 1.0.8 Signed-off-by: Michael Primeaux <[email protected]> * - Added specific references to the underlying charts folder from the root-level README. - Addressed clarifications from @TheAlgo. Signed-off-by: Michael Primeaux <[email protected]> * - Modified change log for the OpenSearch Helm chart. Signed-off-by: Michael Primeaux <[email protected]>
1 parent 7f4bcb3 commit b32e3c6

File tree

9 files changed

+101
-22
lines changed

9 files changed

+101
-22
lines changed

.github/workflows/lint-test.yaml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,8 @@
1+
# See https://github.com/helm/chart-testing-action
12
name: Lint and Test Charts
23

34
on: [pull_request, workflow_dispatch]
4-
5+
56
jobs:
67
lint-test:
78
runs-on: ubuntu-latest

README.md

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -16,22 +16,30 @@ A community repository for Helm Charts of OpenSearch Project.
1616

1717
## Status
1818

19-
![Testing](https://github.com/opensearch-project/helm-charts/workflows/Lint%20and%20Test%20Charts/badge.svg)
20-
![Release](https://github.com/opensearch-project/helm-charts/workflows/Release%20Charts/badge.svg)
19+
[![Lint and Test Charts](https://github.com/opensearch-project/helm-charts/actions/workflows/lint-test.yaml/badge.svg)](https://github.com/opensearch-project/helm-charts/actions/workflows/lint-test.yaml)
20+
[![Release Charts](https://github.com/opensearch-project/helm-charts/actions/workflows/release.yaml/badge.svg)](https://github.com/opensearch-project/helm-charts/actions/workflows/release.yaml)
2121

2222
## Installation
2323

24+
To install the OpenSearch Helm charts, execute the following commands:
25+
2426
```shell
2527
helm repo add opensearch https://opensearch-project.github.io/helm-charts/
2628
helm repo update
2729
```
2830

29-
You can then run `helm search repo opensearch` to see the charts.
31+
Once the charts repository reference is added, you can run the following command to see the charts.
32+
33+
```shell
34+
helm search repo opensearch
35+
```
36+
37+
Please see the `README.md` in the [OpenSearch](charts/opensearch) and [OpenSearch Dashboards](charts/opensearch-dashboards) directories for installation instructions.
3038

3139
## Change Logs
3240

3341
Please review the [OpenSearch](charts/opensearch/CHANGELOG.md) and the
34-
[OpenSearch Dashboards](charts/opensearch/CHANGELOG.md) change logs for the latest
42+
[OpenSearch Dashboards](charts/opensearch-dashboards/CHANGELOG.md) change logs for the latest
3543
release details.
3644

3745
## Contributing

charts/opensearch-dashboards/CHANGELOG.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1313
### Fixed
1414
### Security
1515

16+
---
17+
## [1.0.5]
18+
### Added
19+
### Changed
20+
- Added [README.md](README.md).
21+
### Deprecated
22+
### Removed
23+
### Fixed
24+
### Security
25+
1626
---
1727
## [1.0.4]
1828
### Added
@@ -37,6 +47,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
3747
### Fixed
3848
### Security
3949

40-
[Unreleased]: https://github.com/opensearch-project/helm-charts/compare/opensearch-dashboards-1.0.4...HEAD
50+
[Unreleased]: https://github.com/opensearch-project/helm-charts/compare/opensearch-dashboards-1.0.5...HEAD
51+
[1.0.5]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.4...opensearch-1.0.5
4152
[1.0.4]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.2...opensearch-1.0.4
4253
[1.0.2]: https://github.com/opensearch-project/helm-charts/compare/opensearch-dashboards-1.0.1...opensearch-dashboards-1.0.2

charts/opensearch-dashboards/Chart.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ type: application
1515
# This is the chart version. This version number should be incremented each time you make changes
1616
# to the chart and its templates, including the app version.
1717
# Versions are expected to follow Semantic Versioning (https://semver.org/)
18-
version: 1.0.4
18+
version: 1.0.5
1919

2020
# This is the version number of the application being deployed. This version number should be
2121
# incremented each time you make changes to the application. Versions are not expected to
Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
# OpenSearch Dashboards Helm Chart
2+
3+
This Helm chart installs [OpenSearch Dashboards](https://github.com/opensearch-project/OpenSearch-Dashboards) with configurable TLS, RBAC and much more configurations. This chart caters to a number of different use cases and setups.
4+
5+
- [Requirements](#requirements)
6+
- [Installing](#installing)
7+
- [Uninstalling](#uninstalling)
8+
9+
## Requirements
10+
11+
* Kubernetes >= 1.14
12+
* Helm >= 2.17.0
13+
* We recommend you to have 8 GiB of memory available for this deployment, or at least 4 GiB for the minimum requirement. Else, the deployment is expected to fail.
14+
15+
## Installing
16+
17+
Once you've added this Helm repository as per the repository-level [README](../../README.md#installing)
18+
then you can install the chart as follows:
19+
20+
```shell
21+
helm install my-release opensearch/opensearch-dashboards
22+
```
23+
24+
The command deploys OpenSearch Dashboards with its associated components on the Kubernetes cluster in the default configuration.
25+
26+
**NOTE:** If using Helm 2 then you'll need to add the [`--name`](https://v2.helm.sh/docs/helm/#options-21) command line argument. If unspecified, Helm 2 will autogenerate a name for you.
27+
28+
## Uninstalling
29+
To delete/uninstall the chart with the release name `my-release`:
30+
31+
```shell
32+
helm uninstall my-release
33+
```
34+

charts/opensearch/CHANGELOG.md

Lines changed: 27 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
1212
### Removed
1313
### Fixed
1414
### Security
15+
16+
---
17+
## [1.0.8]
18+
### Added
19+
### Changed
20+
- Amended the installation instructions in the `OpenSearch` Helm chart [README](README.md).
21+
- Amended status badges to GitHub-generated markdown.
22+
### Deprecated
23+
### Removed
24+
### Fixed
25+
### Security
26+
1527
---
1628
## [1.0.6]
1729

@@ -32,6 +44,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
3244
### Fixed
3345
### Security
3446

47+
---
48+
## [1.0.5]
49+
### Added
50+
### Changed
51+
- Added [Usage Notes](README.md#usage-notes) to `README.md` and amended installation instructions.
52+
### Deprecated
53+
### Removed
54+
### Fixed
55+
### Security
56+
3557
---
3658
## [1.0.4]
3759
### Added
@@ -57,6 +79,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
5779
### Fixed
5880
### Security
5981

60-
[Unreleased]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.4...HEAD
82+
[Unreleased]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.8...HEAD
83+
[1.0.8]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.7...opensearch-1.0.8
84+
[1.0.7]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.6...opensearch-1.0.7
85+
[1.0.6]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.5...opensearch-1.0.6
86+
[1.0.5]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.4...opensearch-1.0.5
6187
[1.0.4]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.2...opensearch-1.0.4
6288
[1.0.2]: https://github.com/opensearch-project/helm-charts/compare/opensearch-1.0.1...opensearch-1.0.2

charts/opensearch/Chart.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ type: application
1515
# This is the chart version. This version number should be incremented each time you make changes
1616
# to the chart and its templates, including the app version.
1717
# Versions are expected to follow Semantic Versioning (https://semver.org/)
18-
version: 1.0.7
18+
version: 1.0.8
1919

2020
# This is the version number of the application being deployed. This version number should be
2121
# incremented each time you make changes to the application. Versions are not expected to

charts/opensearch/README.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
This Helm chart installs [OpenSearch](https://github.com/opensearch-project/OpenSearch) with configurable TLS, RBAC and much more configurations. This chart caters a number of different use cases and setups.
44

55
- [Requirements](#requirements)
6-
- [Installing the chart](#installing)
7-
- [Uninstalling the chart](#uninstalling)
6+
- [Installing](#installing)
7+
- [Uninstalling](#uninstalling)
88
- [Configuration](#configuration)
99

1010
## Requirements
@@ -15,21 +15,21 @@ This Helm chart installs [OpenSearch](https://github.com/opensearch-project/Open
1515

1616
## Installing
1717

18-
To install the chart with the release name `my-release`:
19-
- Switch to opensearch directly after cloning the repo
20-
`❯ cd charts/opensearch`
21-
- Run `❯ helm package .`
22-
- Install using Helm 3:
23-
`❯ helm install my-release opensearch-1.0.0.tgz`
24-
- Install using Helm 2
25-
`❯ helm install --name my-release opensearch-1.0.0.tgz`
18+
Once you've added this Helm repository as per the repository-level [README](../../README.md#installing) then you can install the chart as follows:
19+
20+
```shell
21+
helm install my-release opensearch/opensearch
22+
```
2623

2724
The command deploys OpenSearch with its associated components (data statefulsets, masters, clients) on the Kubernetes cluster in the default configuration.
2825

26+
**NOTE:** If using Helm 2 then you'll need to add the [`--name`](https://v2.helm.sh/docs/helm/#options-21) command line argument. If unspecified, Helm 2 will autogenerate a name for you.
27+
2928
## Uninstalling
3029
To delete/uninstall the chart with the release name `my-release`:
31-
```
32-
❯ helm uninstall my-release
30+
31+
```shell
32+
helm uninstall my-release
3333
```
3434

3535
## Configuration

ct.yaml

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,3 @@
1-
# See https://github.com/helm/chart-testing-action
21
# See https://github.com/helm/chart-testing#configuration
32
target-branch: main
43
helm-extra-args: --timeout 800s

0 commit comments

Comments
 (0)