Skip to content

Commit ba185e0

Browse files
committed
Allow AWS compatible cloud services
Users can use their own endpoints for any ec2/s3 compatible API using: `cloud.aws.ec2.endpoint` or `cloud.aws.s3.endpoint` Closes #91. (cherry picked from commit f0fbea5)
1 parent 6a04ae1 commit ba185e0

File tree

1 file changed

+12
-1
lines changed

1 file changed

+12
-1
lines changed

README.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,6 +86,11 @@ One practical use for tag filtering is when an ec2 cluster contains many nodes t
8686
Though not dependent on actually using `ec2` as discovery (but still requires the cloud aws plugin installed), the plugin can automatically add node attributes relating to ec2 (for example, availability zone, that can be used with the awareness allocation feature). In order to enable it, set `cloud.node.auto_attributes` to `true` in the settings.
8787

8888

89+
### Using other EC2 endpoint
90+
91+
If you are using any EC2 api compatible service, you can set the endpoint you want to use by setting `cloud.aws.ec2.endpoint`
92+
to your URL provider.
93+
8994
## S3 Repository
9095

9196
The S3 repository is using S3 to store snapshots. The S3 repository can be created using the following command:
@@ -116,7 +121,7 @@ See [Generic Configuration](#generic-configuration) for details.
116121

117122
Multiple S3 repositories can be created. If the buckets require different credentials, then define them as part of the repository settings.
118123

119-
## Recommended S3 Permissions
124+
### Recommended S3 Permissions
120125

121126
In order to restrict the Elasticsearch snapshot process to the minimum required resources, we recommend using Amazon IAM in conjunction with pre-existing S3 buckets. Here is an example policy which will allow the snapshot access to an S3 bucket named "snaps.example.com". This may be configured through the AWS IAM console, by creating a Custom Policy, and using a Policy Document similar to this (changing snaps.example.com to your bucket name).
122127

@@ -201,6 +206,12 @@ The bucket needs to exist to register a repository for snapshots. If you did not
201206
}
202207
```
203208

209+
### Using other S3 endpoint
210+
211+
If you are using any S3 api compatible service, you can set the endpoint you want to use by setting `cloud.aws.s3.endpoint`
212+
to your URL provider.
213+
214+
204215
## Testing
205216

206217
Integrations tests in this plugin require working AWS configuration and therefore disabled by default. Three buckets and two iam users have to be created. The first iam user needs access to two buckets in different regions and the final bucket is exclusive for the other iam user. To enable tests prepare a config file elasticsearch.yml with the following content:

0 commit comments

Comments
 (0)