87b01037ccae5f96fe2601dcd3b5667357879132
[mdk.git] / mdk / config-dist.json
1 // Moodle Development Kit configuration file
2 //
3 // A comment in this file MUST be preceded by white spaces or nothing.
4 //
5 // This configuration file will be looked for in those directories:
6 // - ~/.moodle-sdk/config.json
7 // - /etc/moodle-sdk/config.json
8 // - <MDK>/config.json
9 //
10 {
11 // Directories to work with.
12 // All of them must exist and must be writeable by the current user.
13 // www and storage CANNOT point to the same directory and must be writeable.
14 "dirs": {
15 // The web directory you are going to access Moodle from, typically your virtual host DocumentRoot.
16 // A symlink to the web directory of your Moodle instance will be created here.
17 "www": "~/www",
18 // The directory where the instances will be stored.
19 "storage": "~/moodles",
20 // A directory used by MDK to store different kind of things such as scripts and backups.
21 "moodle": "~/.moodle-sdk",
22 // Used for cached repositories and stuff which could be shared system-wide.
23 "mdk": "~/.moodle-sdk"
24 },
25
26 // List of remotes to work with
27 // The integration branch MUST end with integration.git
28 "remotes": {
29 "stable": "git://git.moodle.org/moodle.git",
30 "integration": "git://git.moodle.org/integration.git",
31 "mine": "git@github.com:YourGitHub/moodle.git"
32 },
33
34 // Database access
35 "db": {
36 // Name prefix for all databases created by mdk. Affects the database name only, not the tables.
37 "namePrefix": "",
38 "mariadb": {
39 "host": "localhost",
40 "port": "3306",
41 "user": "root",
42 "passwd": "root"
43 },
44 "mysqli": {
45 "host": "localhost",
46 "port": "3306",
47 "user": "root",
48 "passwd": "root"
49 },
50 "pgsql": {
51 "host": "localhost",
52 "port": "5432",
53 "user": "root",
54 "passwd": "root"
55 }
56 },
57
58 // Define the way your want things to be called
59 "wording": {
60
61 // How to name your instances
62 "prefixStable": "stable_",
63 "prefixIntegration": "integration_",
64 "prefixMaster": "master",
65 "suffixSeparator": "_",
66
67 // How to name your branches
68 // Read the doc about Python regular expressions if you need to modify them
69 // http://docs.python.org/library/re.html
70 "branchFormat": "MDL-%(issue)s-%(version)s",
71 "branchSuffixSeparator": "-",
72 "branchRegex": "^MDL-(?P<issue>[0-9]+)-(?P<version>[0-9a-z]+)(-(?P<suffix>[a-z0-9_-]+))?",
73
74 // How to name your Moodle installation
75 "integration": "Integration",
76 "master": "Master",
77 "stable": "Stable",
78 "mariadb": "MariaDB",
79 "mysqli": "MySQL",
80 "pgsql": "PostgreSQL"
81 },
82
83 // CI Server related settings
84 "ci": {
85 "url": "http://integration.moodle.org",
86 "token": null
87 },
88
89 // The information for integrating MDK with Jira
90 "tracker": {
91 "url": "https://tracker.moodle.org/",
92 "username": false,
93 "fieldnames" : {
94 "repositoryurl" : "Pull from Repository",
95 "22" : {
96 "branch" : "Pull 2.2 Branch",
97 "diffurl" : "Pull 2.2 Diff URL"
98 },
99 "23" : {
100 "branch" : "Pull 2.3 Branch",
101 "diffurl" : "Pull 2.3 Diff URL"
102 },
103 "24" : {
104 "branch" : "Pull 2.4 Branch",
105 "diffurl" : "Pull 2.4 Diff URL"
106 },
107 "25" : {
108 "branch" : "Pull 2.5 Branch",
109 "diffurl" : "Pull 2.5 Diff URL"
110 },
111 "26" : {
112 "branch" : "Pull 2.6 Branch",
113 "diffurl" : "Pull 2.6 Diff URL"
114 },
115 "27" : {
116 "branch" : "Pull 2.7 Branch",
117 "diffurl" : "Pull 2.7 Diff URL"
118 },
119 "28" : {
120 "branch" : "Pull 2.8 Branch",
121 "diffurl" : "Pull 2.8 Diff URL"
122 },
123 "29" : {
124 "branch" : "Pull 2.9 Branch",
125 "diffurl" : "Pull 2.9 Diff URL"
126 },
127 "30" : {
128 "branch" : "Pull 3.0 Branch",
129 "diffurl" : "Pull 3.0 Diff URL"
130 },
131 "master" : {
132 "branch" : "Pull Master Branch",
133 "diffurl" : "Pull Master Diff URL"
134 }
135 }
136 },
137 // The base for diff URLs, you can use the following wildcards:
138 // - %branch%: The branch name;
139 // - %stablebranch%: The stable branch (MOODLE_23_STABLE, MOODLE_24_STABLE, master, ...);
140 // - %headcommit%: The head commit.
141 // This is used to populate the fields on the tracker issue.
142 "diffUrlTemplate": "https://github.com/YourGitHub/moodle/compare/%headcommit%...%branch%",
143
144 // The public acccess URL of your repository. It is used to populate the fields on the tracker issue,
145 // and as the common read-only URL of the remote 'myRemote'.
146 "repositoryUrl": "git://github.com/YourGitHub/moodle.git",
147
148 // Plugins related settings.
149 "plugins": {
150
151 // Set this setting to false to disable the caching of plugins locally.
152 "fileCache": true,
153
154 // Local repository for plugins missing on the database.
155 "localRepository": {
156 "auth_mdk": {
157 ">=20": {
158 "downloadurl": "https://github.com/FMCorz/moodle-auth_mdk/archive/master.zip"
159 }
160 }
161 }
162 },
163
164 // The scheme to set during an install (http or https)
165 "scheme": "http",
166 // The host name to set during an install
167 "host": "localhost",
168 // Path to your Moodle instances, http://host/path/ should point to dirs.www.
169 "path": "m",
170 // Moodle admin login
171 "login": "admin",
172 // Moodle admin password
173 "passwd": "test",
174 // What to call your remote, the one pointing to remotes.mine
175 "myRemote": "github",
176 // What to call the upstream remote, the one pointing to the official repositoriy (stable or integration)
177 "upstreamRemote": "origin",
178
179 // Config setting that should be set in config.php when an instance is being installed.
180 "forceCfg": {
181 // The following example will set CFG->divertallemailsto to "root@localhost.local".
182 // "divertallemailsto": "root@localhost.local"
183 },
184
185 // Behat related settings
186 "behat": {
187
188 // From 2.7 Behat requires a different wwwroot than the one set in config.php.
189 // MDK assumes that the only thing that will differ between the wwwroot and
190 // behat wwwroot is the host, nothing else. Use a ServerAlias or /etc/hosts entries.
191 "host": "127.0.0.1",
192 // The number of seconds the behat command will sleep after launching the PHP Server, or Selenium.
193 "launchSleep": 5
194 },
195
196 // The name of the data directory (in dirs.storage/instanceName/)
197 "dataDir": "moodledata",
198 // The name of the www directory (in dirs.storage/instanceName/)
199 "wwwDir": "moodle",
200 // The name of the extra directory, it will be used to store different things of an instance (in dirs.storage/instanceName/)
201 "extraDir": "extra",
202 // The name of the web accessible directory that MDK uses to give access to the extraDirs (created in dirs.www/).
203 "mdkDir": "mdk",
204
205 // The default engine to use when not specified
206 "defaultEngine": "mysqli",
207
208 // Path to Git
209 "git": "/usr/bin/git",
210 // Path to PHP
211 "php": "/usr/bin/php",
212 // Path to Java
213 "java": "/usr/bin/java",
214 // Path to recess
215 "recess": "/usr/local/bin/recess",
216 // Path to lessc
217 "lessc": "/usr/local/bin/lessc",
218 // Path to shifter
219 "shifter": "/usr/bin/shifter",
220 // Path to yuidoc
221 "yuidoc": "/usr/local/bin/yuidoc",
222 // Path to your favourite editor. Set to null to guess it from the System environment.
223 "editor": null,
224
225 // Debug level of MDK. 'debug', 'info', 'warning', 'error' or 'critical'.
226 "debug": "info",
227
228 // When enabled, MDK will try to be smart to identify the parent commit of the current branch. Instead of
229 // using the stable branch it will match the branch name with an issue number and compare it with the commit
230 // messages. The first commit message that does not match the pattern MDL-12345 will be used as the headcommit.
231 "smartHeadCommitSearch": true,
232
233 // Limit the search of the head commit to the last n commits.
234 "smartHeadCommitLimit": 50,
235
236 // Name of the symlink pointing to the data directory to create in the www directory
237 // during an instance creation. If false, the symlink won't be created.
238 "symlinkToData": false,
239
240 // By default MDK caches origin as a local mirror. It is much faster when it comes to upgrading
241 // a couple of instances at the same time. MDK will update the mirror as often as it needs to,
242 // but if you are not using MDK to upgrade your instances, you might want to disable this
243 // functionality to only rely on the real origin. Creating new instances will not be affected
244 // by this setting.
245 "useCacheAsUpstreamRemote": true,
246
247 // You should not edit this, this is the branch that is considered as master by developers.
248 "masterBranch": 31,
249
250 // Aliases for MDK commands.
251 // An alias starting with a ! will be executed through the command line. Those also
252 // can use placeholders for arguments: $1, $2, ...
253 // Examples:
254 // "upall": "update --all". `mdk upall` will execute `mdk update --all`
255 // "ls": "!ls -al". `mdk ls` will execute `ls -al`
256 "aliases": {
257 "check": "doctor",
258 "list": "info -l",
259 "theme": "!mdk info -v theme -e $1 $2"
260 }
261 }