ac5d32907e6626569e0dc65b591a932c897aa346
[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 // The information for integrating MDK with Jira
84 "tracker": {
85 "url": "https://tracker.moodle.org/",
86 "username": false,
87 "fieldnames" : {
88 "repositoryurl" : "Pull from Repository",
89 "22" : {
90 "branch" : "Pull 2.2 Branch",
91 "diffurl" : "Pull 2.2 Diff URL"
92 },
93 "23" : {
94 "branch" : "Pull 2.3 Branch",
95 "diffurl" : "Pull 2.3 Diff URL"
96 },
97 "24" : {
98 "branch" : "Pull 2.4 Branch",
99 "diffurl" : "Pull 2.4 Diff URL"
100 },
101 "25" : {
102 "branch" : "Pull 2.5 Branch",
103 "diffurl" : "Pull 2.5 Diff URL"
104 },
105 "26" : {
106 "branch" : "Pull 2.6 Branch",
107 "diffurl" : "Pull 2.6 Diff URL"
108 },
109 "27" : {
110 "branch" : "Pull 2.7 Branch",
111 "diffurl" : "Pull 2.7 Diff URL"
112 },
113 "master" : {
114 "branch" : "Pull Master Branch",
115 "diffurl" : "Pull Master Diff URL"
116 }
117 }
118 },
119 // The base for diff URLs, you can use the following wildcards:
120 // - %branch%: The branch name;
121 // - %stablebranch%: The stable branch (MOODLE_23_STABLE, MOODLE_24_STABLE, master, ...);
122 // - %headcommit%: The head commit.
123 // This is used to populate the fields on the tracker issue.
124 "diffUrlTemplate": "https://github.com/YourGitHub/moodle/compare/%headcommit%...%branch%",
125
126 // The public acccess URL of your repository. It is used to populate the fields on the tracker issue.
127 "repositoryUrl": "git://github.com/YourGitHub/moodle.git",
128
129 // Plugins related settings.
130 "plugins": {
131
132 // Set this setting to false to disable the caching of plugins locally.
133 "fileCache": true,
134
135 // Local repository for plugins missing on the database.
136 "localRepository": {
137 "auth_mdk": {
138 ">=20": {
139 "downloadurl": "https://github.com/FMCorz/moodle-auth_mdk/archive/master.zip"
140 }
141 }
142 }
143 },
144
145 // The scheme to set during an install (http or https)
146 "scheme": "http",
147 // The host name to set during an install
148 "host": "localhost",
149 // Path to your Moodle instances, http://host/path/ should point to dirs.www.
150 "path": "m",
151 // Moodle admin login
152 "login": "admin",
153 // Moodle admin password
154 "passwd": "test",
155 // What to call your remote, the one pointing to remotes.mine
156 "myRemote": "github",
157 // What to call the upstream remote, the one pointing to the official repositoriy (stable or integration)
158 "upstreamRemote": "origin",
159
160 // Config setting that should be set in config.php when an instance is being installed.
161 "forceCfg": {
162 // The following example will set CFG->divertallemailsto to "root@localhost.local".
163 // "divertallemailsto": "root@localhost.local"
164 },
165
166 // Behat related settings
167 "behat": {
168
169 // From 2.7 Behat requires a different wwwroot than the one set in config.php.
170 // MDK assumes that the only thing that will differ between the wwwroot and
171 // behat wwwroot is the host, nothing else. Use a ServerAlias or /etc/hosts entries.
172 "host": "127.0.0.1",
173 // The number of seconds the behat command will sleep after launching the PHP Server, or Selenium.
174 "launchSleep": 5
175 },
176
177 // The name of the data directory (in dirs.storage/instanceName/)
178 "dataDir": "moodledata",
179 // The name of the www directory (in dirs.storage/instanceName/)
180 "wwwDir": "moodle",
181 // The name of the extra directory, it will be used to store different things of an instance (in dirs.storage/instanceName/)
182 "extraDir": "extra",
183 // The name of the web accessible directory that MDK uses to give access to the extraDirs (created in dirs.www/).
184 "mdkDir": "mdk",
185
186 // The default engine to use when not specified
187 "defaultEngine": "mysqli",
188
189 // Path to Git
190 "git": "/usr/bin/git",
191 // Path to PHP
192 "php": "/usr/bin/php",
193 // Path to Java
194 "java": "/usr/bin/java",
195 // Path to recess
196 "recess": "/usr/local/bin/recess",
197 // Path to lessc
198 "lessc": "/usr/local/bin/lessc",
199 // Path to shifter
200 "shifter": "/usr/bin/shifter",
201 // Path to yuidoc
202 "yuidoc": "/usr/local/bin/yuidoc",
203 // Path to your favourite editor. Set to null to guess it from the System environment.
204 "editor": null,
205
206 // Debug level of MDK. 'debug', 'info', 'warning', 'error' or 'critical'.
207 "debug": "info",
208
209 // When enabled, MDK will try to be smart to identify the parent commit of the current branch. Instead of
210 // using the stable branch it will match the branch name with an issue number and compare it with the commit
211 // messages. The first commit message that does not match the pattern MDL-12345 will be used as the headcommit.
212 "smartHeadCommitSearch": true,
213
214 // Limit the search of the head commit to the last n commits.
215 "smartHeadCommitLimit": 50,
216
217 // Name of the symlink pointing to the data directory to create in the www directory
218 // during an instance creation. If false, the symlink won't be created.
219 "symlinkToData": false,
220
221 // By default MDK caches origin as a local mirror. It is much faster when it comes to upgrading
222 // a couple of instances at the same time. MDK will update the mirror as often as it needs to,
223 // but if you are not using MDK to upgrade your instances, you might want to disable this
224 // functionality to only rely on the real origin. Creating new instances will not be affected
225 // by this setting.
226 "useCacheAsUpstreamRemote": true,
227
228 // You should not edit this, this is the branch that is considered as master by developers.
229 "masterBranch": 29,
230
231 // Aliases for MDK commands.
232 // An alias starting with a ! will be executed through the command line. Those also
233 // can use placeholders for arguments: $1, $2, ...
234 // Examples:
235 // "upall": "update --all". `mdk upall` will execute `mdk update --all`
236 // "ls": "!ls -al". `mdk ls` will execute `ls -al`
237 "aliases": {
238 "check": "doctor",
239 "list": "info -l",
240 "theme": "!mdk info -v theme -e $1 $2"
241 }
242 }