ReleaseEngineering/Applications/Mapper: Difference between revisions

new mapper url
(update staging URL)
(new mapper url)
 
Line 18: Line 18:
# b2g_build.py - the build script for b2g - since this needs to lookup shas in order to reference frozen commit versions in manifests
# b2g_build.py - the build script for b2g - since this needs to lookup shas in order to reference frozen commit versions in manifests


Mapper is written as a RelEng API blueprint - please note RelEng API has its [https://api.pub.build.mozilla.org/docs/ own documentation] too.
Mapper is written as a RelEng API blueprint - please note RelEng API has its [https://docs.mozilla-releng.net/projects/releng-mapper.html own documentation] too.




= Mapper Development & Deployment =
= Mapper Development & Deployment =


The mapper is a Releng API blueprint, and so the details about how to deploy locally for development, and where the staging/production environments are, can be seen in the [https://api.pub.build.mozilla.org/docs/ RelEngAPI documentation].
The mapper is a project in [https://github.com/mozilla-releng/services mozilla-releng/services] repository, and so the details about how to deploy locally for development, and where the staging/production environments are, can be seen in the [https://docs.mozilla-releng.net/ RelEngAPI documentation].




Line 34: Line 34:
Below is a summary of the 4 unauthenticated API methods currently usable, together with example urls from the production environment.
Below is a summary of the 4 unauthenticated API methods currently usable, together with example urls from the production environment.


For fuller details, and endpoints requiring authentication, the in process documentation is authoritative: [https://api.pub.build.mozilla.org/docs/usage/mapper/ production] or [https://api-pub-build.allizom.org/docs/usage/mapper/ staging] instances.
For fuller details, and endpoints requiring authentication, the in process documentation is authoritative: [https://mapper.mozilla-releng.net/docs production] or [https://mapper.staging.mozilla-releng.net/docs staging] instances.


== GET Routes ==
== GET Routes ==
Line 40: Line 40:
=== Returns a mapping pair ===
=== Returns a mapping pair ===
* GET:  /<project>/rev/<vcs_type>/<commit>
* GET:  /<project>/rev/<vcs_type>/<commit>
* Example: https://api.pub.build.mozilla.org/mapper/build-puppet/rev/git/69d64a8a18e6e001eb015646a82bcdaba0e78a24
* Example: https://mapper.mozilla-releng.net/build-puppet/rev/git/69d64a8a18e6e001eb015646a82bcdaba0e78a24
* Example: https://api.pub.build.mozilla.org/mapper/build-puppet/rev/hg/68f1b2b9996c4e33aa57771b3478932c9fb7e161
* Example: https://mapper.mozilla-releng.net/build-puppet/rev/hg/68f1b2b9996c4e33aa57771b3478932c9fb7e161


=== Returns full mapfile for a given project ===
=== Returns full mapfile for a given project ===
* GET:  /<project>/mapfile/full
* GET:  /<project>/mapfile/full
* Example: https://api.pub.build.mozilla.org/mapper/build-puppet/mapfile/full
* Example: https://mapper.mozilla-releng.net/build-puppet/mapfile/full


=== Returns a subset of a mapfile, since a given date ===
=== Returns a subset of a mapfile, since a given date ===
* GET:  /<project>/mapfile/since/<since>
* GET:  /<project>/mapfile/since/<since>
* Example: https://api.pub.build.mozilla.org/mapper/build-mozharness/mapfile/since/29.05.2014%2017:02:09%20CEST
* Example: https://mapper.mozilla-releng.net/build-mozharness/mapfile/since/29.05.2014%2017:02:09%20CEST


=== Returns list of projects ===
=== Returns list of projects ===
* GET:  /projects
* GET:  /projects
* Example: https://api.pub.build.mozilla.org/mapper/projects
* Example: https://mapper.mozilla-releng.net/projects


= Staging =
= Staging =


The staging environment is available under https://api-pub-build.allizom.org/ (Look under "Documentation" to find details.)
The staging environment is available under https://mapper.staging.mozilla-releng.net (Look under "Documentation" to find details.)
14

edits