How to replicate design documents only?

Question

So I want to replicate some changes I made to my design files from dev to production (a.k.a. I want to deploy something).

I'm somehow confused since my research did not lead to any concrete results. Although this seams IMHO like a pretty obvious use case.

Am I missing something?

score 18 · Accepted Answer · answered Sep 05 '11 at 20:45

18

You can specify the document IDs to replicate, without having to write a filter. Post the replication document (or command) like so:

{ "source": "my_db"
, "target": "http://target:5984/target_db"
, "doc_ids": [ "_design/my_ddoc" ]
}

answered Sep 05 '11 at 20:45

JasonSmith

Also the way faster solution. Thanks! – Aron Woost Sep 08 '11 at 07:53
1

Make sure you are using admin user for the replication to succeed under target pass user/pass in the url "target":"http://admin:password@ip/db" , only admins can create design documents – doron aviguy May 21 '16 at 07:43

score 9 · Answer 2 · answered Sep 05 '11 at 16:08

9

Basically, you'll supply a function that returns true for design documents like;

function(doc, req) {
  return "_design/" === doc._id.substr(0, 8)
}

and then add "filter":"ddocname/filtername" to your _replicate request body.

answered Sep 05 '11 at 16:08

Robert Newson

In this case you probably want to just replicate the named ID as shown by JasonSmith and not perform a more general replication. – Ewan Makepeace Sep 07 '11 at 03:18
1

Robert's solution most directly answers the question. In my solution, you must know the document IDs. In his, CouchDB figures that out for you. I think in practice, people do indeed know their design document ids however. – JasonSmith Sep 09 '11 at 07:00
I have found filters to be very slow. Using the name of the design doc is better for most cases. – Mike McKay Jun 09 '12 at 20:06
This fits a database-per-user pattern pretty well. Especially if you're already doing a filtered replication to populate the new users database. – MrYellow Jan 24 '15 at 02:03

score 1 · Answer 3 · answered May 06 '13 at 16:10

I keep my design documents stored as .js files on disk. Then I use couchdb-update-views to update the design documents on a server

npm install -g couchdb-update-views
couchdb-update-views --config /path/to/config.json --docsDir /path/to/design/docs/directory/

3 Answers3