FOSElasticaBundle/Resources/doc/cookbook/aliased-indexes.md
2014-07-04 13:07:35 +10:00

1.3 KiB

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.

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.

fos_elastica:
    indexes:
        website:
            use_alias: true
            index_name: website_prod
$ curl -XPOST 'http://localhost:9200/_aliases' -d '
{
    "actions" : [
        { "add" : { "index" : "website", "alias" : "website_prod" } }
    ]
}'