Skip to content

Commit 580a419

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 73bd1f7 commit 580a419

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
@@ -85,6 +85,11 @@ One practical use for tag filtering is when an ec2 cluster contains many nodes t
8585

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

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

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

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

118-
## Recommended S3 Permissions
123+
### Recommended S3 Permissions
119124

120125
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).
121126

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

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

205216
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)