Documentation on aliased repopulation
This commit is contained in:
parent
90a554f627
commit
bf38e59e49
45
Resources/doc/cookbook/aliased-indexes.md
Normal file
45
Resources/doc/cookbook/aliased-indexes.md
Normal file
|
@ -0,0 +1,45 @@
|
||||||
|
Aliased Indexes
|
||||||
|
===============
|
||||||
|
|
||||||
|
You can set up FOSElasticaBundle to use aliases for indexes which allows you to run an
|
||||||
|
index population without resetting the index currently being used by the application.
|
||||||
|
|
||||||
|
> *Note*: When you're using an alias, resetting an individual type will still cause a
|
||||||
|
> reset for that type.
|
||||||
|
|
||||||
|
To configure FOSElasticaBundle to use aliases for an index, set the use_alias option to
|
||||||
|
true.
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
fos_elastica:
|
||||||
|
indexes:
|
||||||
|
website:
|
||||||
|
use_alias: true
|
||||||
|
```
|
||||||
|
|
||||||
|
The process for setting up aliases on an existing application is slightly more complicated
|
||||||
|
because the bundle is not able to set an alias as the same name as an index. You have some
|
||||||
|
options on how to handle this:
|
||||||
|
|
||||||
|
1) Delete the index from Elasticsearch. This option will make searching unavailable in your
|
||||||
|
application until a population has completed itself, and an alias is created.
|
||||||
|
|
||||||
|
2) Change the index_name parameter for your index to something new, and manually alias the
|
||||||
|
current index to the new index_name, which will then be replaced when you run a repopulate.
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
fos_elastica:
|
||||||
|
indexes:
|
||||||
|
website:
|
||||||
|
use_alias: true
|
||||||
|
index_name: website_prod
|
||||||
|
```
|
||||||
|
|
||||||
|
```bash
|
||||||
|
$ curl -XPOST 'http://localhost:9200/_aliases' -d '
|
||||||
|
{
|
||||||
|
"actions" : [
|
||||||
|
{ "add" : { "index" : "website", "alias" : "website_prod" } }
|
||||||
|
]
|
||||||
|
}'
|
||||||
|
```
|
|
@ -12,6 +12,7 @@ Available documentation for FOSElasticaBundle
|
||||||
Cookbook Entries
|
Cookbook Entries
|
||||||
----------------
|
----------------
|
||||||
|
|
||||||
|
* [Aliased Indexes](cookbook/aliased-indexes.md)
|
||||||
* [Custom Repositories](cookbook/custom-repositories.md)
|
* [Custom Repositories](cookbook/custom-repositories.md)
|
||||||
* [HTTP Headers for Elastica](cookbook/elastica-client-http-headers.md)
|
* [HTTP Headers for Elastica](cookbook/elastica-client-http-headers.md)
|
||||||
* Performance - [Logging](cookbook/logging.md)
|
* Performance - [Logging](cookbook/logging.md)
|
||||||
|
|
Loading…
Reference in a new issue