• Home
  • History
  • Annotate
  • only in /external/chromium_org/chrome/common/extensions/docs/server2/
NameDateSize

..12-Mar-20154 KiB

.gitignore12-Mar-201526

api_categorizer.py12-Mar-20151.7 KiB

api_categorizer_test.py12-Mar-20152.4 KiB

api_data_source.py12-Mar-20154.2 KiB

api_data_source_test.py12-Mar-20155.5 KiB

api_list_data_source.py12-Mar-20154.8 KiB

api_list_data_source_test.py12-Mar-20157.8 KiB

api_models.py12-Mar-20156.8 KiB

api_models_test.py12-Mar-20156.5 KiB

api_schema_graph.py12-Mar-201513.4 KiB

api_schema_graph_test.py12-Mar-201516.7 KiB

app.yaml12-Mar-2015484

app_engine_handler.py12-Mar-20151.7 KiB

app_yaml_helper.py12-Mar-20154.6 KiB

app_yaml_helper_test.py12-Mar-20156 KiB

appengine_blobstore.py12-Mar-20151.9 KiB

appengine_main.py12-Mar-2015645

appengine_url_fetcher.py12-Mar-20152.6 KiB

appengine_wrappers.py12-Mar-20158.4 KiB

availability_finder.py12-Mar-201519.7 KiB

availability_finder_test.py12-Mar-201513.8 KiB

blob_reference_store.py12-Mar-20151.1 KiB

branch_utility.py12-Mar-20158.3 KiB

branch_utility_test.py12-Mar-20157.5 KiB

build_server.py12-Mar-20153.3 KiB

cache_chain_object_store.py12-Mar-20153.2 KiB

cache_chain_object_store_test.py12-Mar-20158.3 KiB

caching_file_system.py12-Mar-20157.3 KiB

caching_file_system_test.py12-Mar-201511.3 KiB

caching_rietveld_patcher.py12-Mar-20154.1 KiB

caching_rietveld_patcher_test.py12-Mar-20152.3 KiB

chained_compiled_file_system.py12-Mar-20154.1 KiB

chained_compiled_file_system_test.py12-Mar-20152.8 KiB

chrome-128.png12-Mar-20153.9 KiB

chrome-32.ico12-Mar-20155.3 KiB

chroot_file_system.py12-Mar-20151.8 KiB

chroot_file_system_test.py12-Mar-20153.6 KiB

compiled_file_system.py12-Mar-201510.5 KiB

compiled_file_system_test.py12-Mar-20159.3 KiB

content_provider.py12-Mar-20158.2 KiB

content_provider_test.py12-Mar-20157.6 KiB

content_providers.py12-Mar-20157.5 KiB

content_providers_test.py12-Mar-20156.6 KiB

converter_html_parser.py12-Mar-20151.7 KiB

cron.yaml12-Mar-2015131

cron_servlet.py12-Mar-20157.5 KiB

cron_servlet_test.py12-Mar-201510.2 KiB

custom_logger.py12-Mar-2015845

data_source.py12-Mar-20151.5 KiB

data_source_registry.py12-Mar-20152 KiB

datastore_models.py12-Mar-20151.2 KiB

directory_zipper.py12-Mar-20152.2 KiB

directory_zipper_test.py12-Mar-20151.8 KiB

docs_server_utils.py12-Mar-20151.7 KiB

docs_server_utils_test.py12-Mar-2015958

document_parser.py12-Mar-20157.4 KiB

document_parser_test.py12-Mar-20158.3 KiB

document_renderer.py12-Mar-20154.5 KiB

document_renderer_test.py12-Mar-20155.7 KiB

empty_dir_file_system.py12-Mar-20151,006

environment.py12-Mar-20151.2 KiB

environment_test.py12-Mar-20151.6 KiB

extensions_paths.py12-Mar-20151.5 KiB

fail_on_access_file_system.py12-Mar-2015406

fake_fetchers.py12-Mar-20156.1 KiB

fake_host_file_system_provider.py12-Mar-2015624

fake_url_fetcher.py12-Mar-20154.8 KiB

features_bundle.py12-Mar-201514.5 KiB

features_bundle_test.py12-Mar-201515.9 KiB

file_system.py12-Mar-20157.7 KiB

file_system_test.py12-Mar-20153.6 KiB

file_system_util.py12-Mar-2015534

future.py12-Mar-20153.9 KiB

future_test.py12-Mar-20159.1 KiB

gcs_file_system.py12-Mar-20154.6 KiB

gcs_file_system_provider.py12-Mar-20153.7 KiB

github_file_system.py12-Mar-20157.2 KiB

github_file_system_provider.py12-Mar-20151.6 KiB

github_file_system_test.py12-Mar-20151.6 KiB

gitiles_file_system.py12-Mar-20158.6 KiB

gitiles_file_system_test.py12-Mar-20155.1 KiB

handler.py12-Mar-20151.7 KiB

handler_test.py12-Mar-2015468

host_file_system_iterator.py12-Mar-20151.5 KiB

host_file_system_iterator_test.py12-Mar-20158 KiB

host_file_system_provider.py12-Mar-20154.7 KiB

host_file_system_provider_test.py12-Mar-20151.7 KiB

instance_servlet.py12-Mar-20153.7 KiB

instance_servlet_test.py12-Mar-20152.1 KiB

integration_test.py12-Mar-201511.1 KiB

jsc_view.py12-Mar-201521.5 KiB

jsc_view_test.py12-Mar-201515 KiB

known_broken_links.json12-Mar-201541.8 KiB

link_converter.py12-Mar-20152.9 KiB

link_error_detector.py12-Mar-201510.1 KiB

link_error_detector_test.py12-Mar-20153 KiB

local_file_system.py12-Mar-20153.4 KiB

local_file_system_test.py12-Mar-20151,014

local_renderer.py12-Mar-2015686

manifest_data_source.py12-Mar-20155 KiB

manifest_data_source_test.py12-Mar-20156.2 KiB

manifest_features.py12-Mar-20151.6 KiB

manifest_features_test.py12-Mar-20151.1 KiB

memcache_object_store.py12-Mar-20151.2 KiB

mock_file_system.py12-Mar-20154.4 KiB

mock_file_system_test.py12-Mar-20154.6 KiB

mock_function.py12-Mar-20151 KiB

mock_function_test.py12-Mar-20151.2 KiB

new_github_file_system.py12-Mar-201510.9 KiB

new_github_file_system_test.py12-Mar-20159.9 KiB

object_store.py12-Mar-20151.2 KiB

object_store_creator.py12-Mar-20153.2 KiB

object_store_creator_test.py12-Mar-20151.9 KiB

offline_file_system.py12-Mar-2015897

owners_data_source.py12-Mar-20153.4 KiB

owners_data_source_test.py12-Mar-20154.6 KiB

patch_servlet.py12-Mar-20154.7 KiB

patch_servlet_test.py12-Mar-20156.5 KiB

patched_file_system.py12-Mar-20155.5 KiB

patched_file_system_test.py12-Mar-20156.5 KiB

patcher.py12-Mar-20151 KiB

path_canonicalizer.py12-Mar-20154.7 KiB

path_canonicalizer_test.py12-Mar-20156 KiB

path_util.py12-Mar-20152.7 KiB

path_util_test.py12-Mar-20151.9 KiB

permissions_data_source.py12-Mar-20153.6 KiB

permissions_data_source_test.py12-Mar-20155 KiB

persistent_object_store.py12-Mar-20151.6 KiB

persistent_object_store_test.py12-Mar-20151.7 KiB

platform_bundle.py12-Mar-20155.4 KiB

platform_bundle_test.py12-Mar-20154.3 KiB

platform_util.py12-Mar-2015912

platform_util_test.py12-Mar-20151.5 KiB

PRESUBMIT.py12-Mar-20153.5 KiB

preview.py12-Mar-20154.1 KiB

queue.yaml12-Mar-201589

README12-Mar-20152.6 KiB

redirector.py12-Mar-20153.7 KiB

redirector_test.py12-Mar-20157.5 KiB

reference_resolver.py12-Mar-20156.8 KiB

reference_resolver_test.py12-Mar-20159.2 KiB

refresh_servlet.py12-Mar-20155.4 KiB

render_refresher.py12-Mar-20153.4 KiB

render_servlet.py12-Mar-20156 KiB

render_servlet_test.py12-Mar-20155.9 KiB

rietveld_patcher.py12-Mar-20154.5 KiB

rietveld_patcher_test.py12-Mar-20152.7 KiB

robots.txt12-Mar-201551

samples_data_source.py12-Mar-20152.7 KiB

samples_model.py12-Mar-20156.7 KiB

samples_model_test.py12-Mar-20151.2 KiB

schema_processor.py12-Mar-20158.4 KiB

schema_processor_test.py12-Mar-20156.2 KiB

server_instance.py12-Mar-20155.5 KiB

servlet.py12-Mar-20154.4 KiB

sidenav_data_source.py12-Mar-20153.5 KiB

sidenav_data_source_test.py12-Mar-20154.9 KiB

special_paths.py12-Mar-2015405

start_dev_server.py12-Mar-2015915

strings_data_source.py12-Mar-2015904

subversion_file_system.py12-Mar-20157.7 KiB

subversion_file_system_test.py12-Mar-20155.4 KiB

table_of_contents_renderer.py12-Mar-20152 KiB

template_data_source.py12-Mar-20151.8 KiB

template_data_source_test.py12-Mar-20152.3 KiB

template_renderer.py12-Mar-20151.6 KiB

template_renderer_test.py12-Mar-2015921

test_branch_utility.py12-Mar-20152.2 KiB

test_data/12-Mar-20154 KiB

test_file_system.py12-Mar-20154.7 KiB

test_file_system_test.py12-Mar-20157.7 KiB

test_object_store.py12-Mar-20152 KiB

test_object_store_test.py12-Mar-20151.5 KiB

test_patcher.py12-Mar-20151 KiB

test_servlet.py12-Mar-20152.7 KiB

test_servlet_test.py12-Mar-20151.4 KiB

test_util.py12-Mar-20151.7 KiB

timer.py12-Mar-20151.7 KiB

update_server.py12-Mar-20152 KiB

url_constants.py12-Mar-20151.1 KiB

whats_new_data_source.py12-Mar-20153.4 KiB

whats_new_data_source_test.py12-Mar-20152.9 KiB

README

1--------
2Overview
3
4This is a Google App Engine server which serves the documentation for Chrome
5apps and extensions. At time of this writing, the primary URL is:
6http://developer.chrome.com/.
7
8
9---------------------
10Developing the Server
11
12You shouldn't need app engine locally to develop the server, preview.py should
13be sufficient. If for some reason you want to test against the app engine SDK:
14
15  1. Download the python Google App Engine SDK from:
16     https://developers.google.com/appengine/downloads
17
18  2. Run './start_dev_server.py <path/to/dev_appserver.py>'
19     (dev_appserver.py is part of the App Engine)
20
21  3. View docs at http://localhost:8080/(apps|extensions)/<doc_name>
22
23
24--------------------------------------------
25Using Google Cloud Storage content providers
26
27With preview.py:
28
29  1. create a directory "[...]/server2/local_debug/gcs/<bucketname>" for every
30     gcs bucket referenced in content_providers.json
31
32  2. copy files to the respective local bucket directories. Preview.py has
33     no access to the real Google Cloud Storage.
34
35With start_dev_server.py:
36
37    1. Install gsutils from https://developers.google.com/storage/docs/gsutil
38
39    2. Set gsutil accordingly to the official instructions.
40
41    3. Make sure you have permission to the GCS buckets specified in
42       content_providers.json by running "gsutil ls gs://bucketname"
43
44    4. Get an oauth token (see instructions at the comment of
45       gcs_file_system_provider.py) and save it to the file
46       "[...]/server2/local_debug/gcs_debug.conf"
47
48Remember that the step 4 needs to be repeated every 10 minutes or so,
49because the oauth access token expires quickly.
50
51--------------------
52Deploying the Server
53
54You will need to have access to the http://chrome-apps-doc.appspot.com app.
55Contact aa@chromium.org, erikkay@chromium.org, miket@chromium.org,
56kalman@chromium.org, or ernestd@chromium.org to obtain access.
57
58Once you have access:
59
601. Increment the version in app.yaml so we can roll back if the update breaks.
61
622. Run build_server.py. This copies some depenencies from /third_party into the
63   server directory so that they get uploaded to App Engine.
64
653. Run appcfg.py (supplied with the App Engine SDK) to upload the server code:
66
67    appcfg.py update .
68
694. When prompted for your credentials, enter the information for the account
70   that has access to the production app.
71
725. Go to http://www.appspot.com, select the docs project, click "versions" in
73   the sidebar, and make the version you just deployed the "default" version.
74
75   If you get an error about too many versions when deploying, go into this
76   view and delete the version which was deployed the longest time ago.  Then
77   try to deploy again.
78