Please Clarify Agent Auto Config Steps

25 views
Skip to first unread message

Ross G

unread,
Oct 14, 2022, 1:09:27 AM10/14/22
to go-cd
Hi, can you please clarify what this step in the documentation means?

Add an attribute named “agentAutoRegisterKey”, for e.g., agentAutoRegisterKey=“388b633a88de126531afa41eff9aa69e”, in the server configuration fragment, in case it is not present

  • What file is that and where do I find that in a server container?
  • Should I be randomly generating this key? if so, what is the definition of the key length and allowed characters?
Thanks,

Chad Wilson

unread,
Oct 14, 2022, 1:22:16 AM10/14/22
to go...@googlegroups.com
Hi Ross

The auto-registration key it refers to is automatically generated when your server first starts (if not present). It's persisted to the server config, stored at different locations depending on your installation type. For a container it's at https://hub.docker.com/r/gocd/gocd-server "Under the Hood", i.e /godata/config/config.xml (generally for a container you will be mounting a volume to /godata so it is persisted)

When auto-generated by the server on start-up it's a UUIDv4 (generated from a secure random number generator, represented as a string), but doesn't have to be - and is treated as a string everywhere I believe, so you can edit it yourself to something else if you would prefer something even more secure/random.

-Chad


--
You received this message because you are subscribed to the Google Groups "go-cd" group.
To unsubscribe from this group and stop receiving emails from it, send an email to go-cd+un...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/go-cd/f2b159da-300d-4a2f-be30-21cdf385d585n%40googlegroups.com.

Ross G

unread,
Oct 14, 2022, 5:10:17 PM10/14/22
to go-cd
Thanks, yes I have mounted persistant storage at /godata

The file appears to be called cruise-config.xm is that expected?

/godata/config $ ls -al
total 84
drwxr-xr-x    2 go       root          4096 Oct 12 03:48 .
drwxr-xr-x   10 go       root          4096 Oct 14 04:50 ..
-rw-r--r--    1 go       root            32 Oct 12 03:48 cipher.aes
-rw-r--r--    1 go       root           502 Oct 14 20:58 cruise-config.xml
-rw-r--r--    1 go       root         47442 Oct 14 20:57 cruise-config.xsd
-rw-r--r--    1 go       root           165 Oct 12 03:41 db.properties
-rw-r--r--    1 go       root           799 Oct 12 03:48 go_update_server.pub
-rw-r--r--    1 go       root          4305 Oct 12 03:48 jetty.xml
-rw-r--r--    1 go       root          1032 Oct 12 03:48 logback-include.xml

Chad Wilson

unread,
Oct 14, 2022, 10:29:57 PM10/14/22
to go...@googlegroups.com
Ahh yes - sorry my bad :-)

Reply all
Reply to author
Forward
0 new messages