Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(500)

Side by Side Diff: chrome/common/extensions/docs/server2/README

Issue 2250823003: [Extension DocServer] Update BranchUtility, README (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Update usernames Created 4 years, 4 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « no previous file | chrome/common/extensions/docs/server2/app.yaml » ('j') | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 -------- 1 --------
2 Overview 2 Overview
3 3
4 This is a Google App Engine server which serves the documentation for Chrome 4 This is a Google App Engine server which serves the documentation for Chrome
5 apps and extensions. At time of this writing, the primary URL is: 5 apps and extensions. At time of this writing, the primary URL is:
6 http://developer.chrome.com/. 6 http://developer.chrome.com/.
7 7
8 8
9 --------------------- 9 ---------------------
10 Developing the Server 10 Developing the Server
(...skipping 30 matching lines...) Expand all
41 You may also specify --commit=<commitish> when running update_cache.py in 41 You may also specify --commit=<commitish> when running update_cache.py in
42 order to update the cache from a specific commit. This may be a commit ID, 42 order to update the cache from a specific commit. This may be a commit ID,
43 or a partial commit ID, or a local branch ref, etc. To test local changes, 43 or a partial commit ID, or a local branch ref, etc. To test local changes,
44 you MUST commit them locally and use the local commit to update your cache. 44 you MUST commit them locally and use the local commit to update your cache.
45 45
46 2. Once you have a cache (e.g. FOOCACHE) in the working directory of your 46 2. Once you have a cache (e.g. FOOCACHE) in the working directory of your
47 dev server, visit the URL: 47 dev server, visit the URL:
48 48
49 http://localhost:8080/_update_cache/FOOCACHE 49 http://localhost:8080/_update_cache/FOOCACHE
50 50
51 If you see errors about the FOOCACHE file not existing, the server may be
52 looking for the file in the root chromium directory (under src/), even if
53 you launched the server from the server2 directory. Try moving the FOOCACHE
54 file there.
55
51 The server should take about a minute to fully populate its Datastore 56 The server should take about a minute to fully populate its Datastore
52 from the data in your FOOCACHE file. Now you have a working dev server! 57 from the data in your FOOCACHE file. Now you have a working dev server!
53 58
54 59
55 ------------------------------------------------------------ 60 ------------------------------------------------------------
56 Using Google Cloud Storage content providers with preview.py 61 Using Google Cloud Storage content providers with preview.py
57 62
58 1. create a directory "[...]/server2/local_debug/gcs/<bucketname>" for every 63 1. create a directory "[...]/server2/local_debug/gcs/<bucketname>" for every
59 gcs bucket referenced in content_providers.json 64 gcs bucket referenced in content_providers.json
60 65
61 2. copy files to the respective local bucket directories. Preview.py has 66 2. copy files to the respective local bucket directories. Preview.py has
62 no access to the real Google Cloud Storage. 67 no access to the real Google Cloud Storage.
63 68
64 69
65 -------------------- 70 --------------------
66 Deploying the Server 71 Deploying the Server
67 72
68 You will need to have access to the http://chrome-apps-doc.appspot.com app. 73 You will need to have access to the http://chrome-apps-doc.appspot.com app.
69 Contact kalman@chromium.org or rockot@chromium.org to obtain access. 74 Contact rdevlin.cronin@chromium.org or another extensions team member to obtain
75 access.
70 76
71 Once you have access: 77 Once you have access:
72 78
73 1. Increment the version in app.yaml so we can roll back if the update breaks. 79 1. Increment the version in app.yaml so we can roll back if the update breaks.
74 80
75 2. Run build_server.py. This copies some depenencies from /third_party into the 81 2. Run build_server.py. This copies some depenencies from /third_party into the
76 server directory so that they get uploaded to App Engine. 82 server directory so that they get uploaded to App Engine.
77 83
78 3. Run appcfg.py (supplied with the App Engine SDK) to upload the server code: 84 3. Run appcfg.py (supplied with the App Engine SDK) to upload the server code:
79 85
(...skipping 37 matching lines...) Expand 10 before | Expand all | Expand 10 after
117 consider the case where no new commits are landing in the chrome repository 123 consider the case where no new commits are landing in the chrome repository
118 but a change was just pushed to one of the GCS providers (like say, the 124 but a change was just pushed to one of the GCS providers (like say, the
119 chromedocs-multidevice bucker). In this case, you may want to force an update 125 chromedocs-multidevice bucker). In this case, you may want to force an update
120 of only the content_providers data. 126 of only the content_providers data.
121 127
122 ./update_docs.sh --data-source=content_providers --force 128 ./update_docs.sh --data-source=content_providers --force
123 129
124 This will safely do the push for you, ensuring that the automated job 130 This will safely do the push for you, ensuring that the automated job
125 does not collide with your own. 131 does not collide with your own.
126 132
OLDNEW
« no previous file with comments | « no previous file | chrome/common/extensions/docs/server2/app.yaml » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698