You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: branches/pubsub-alpha/CONTRIBUTING.md
-14Lines changed: 0 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,20 +15,6 @@ Using maven for build/test
15
15
After you cloned the repository use Maven for building and running the tests.
16
16
Maven 3.0+ is required.
17
17
18
-
When downloading the source, we recommend you obtain service account credentials.
19
-
These credentials will allow you to run integration tests using `mvn verify` in command line.
20
-
Follow step 2 of the [authentication instructions](https://github.com/GoogleCloudPlatform/gcloud-java#authentication) to generate and use JSON service account credentials.
21
-
22
-
It's also important to test that changes don't break compatibility with App/Compute Engine and when running elsewhere.
23
-
To run tests on different platforms, try deploying the apps available on the [gcloud-java-examples](https://github.com/GoogleCloudPlatform/gcloud-java-examples) repository.
24
-
End-to-end tests should ensure that gcloud-java works when running on the
25
-
26
-
* App Engine production environment (see the docs for [uploading your app to production App Engine](https://cloud.google.com/appengine/docs/java/tools/maven#uploading_your_app_to_production_app_engine))
27
-
* App Engine development server (see the docs for [testing your app with the development server](https://cloud.google.com/appengine/docs/java/tools/maven#testing_your_app_with_the_development_server))
28
-
* Compute Engine (see the [Getting Started Guide](https://cloud.google.com/compute/docs/quickstart), and be sure to [enable the appropriate APIs](https://github.com/GoogleCloudPlatform/gcloud-common/tree/master/authentication#on-google-compute-engine))
29
-
* Your desktop (using `mvn exec:java`, for example)
30
-
31
-
When changes are made to authentication and project ID-related code, authentication and project ID inference should be tested using all relevant methods detailed in the [authentication docs](https://github.com/GoogleCloudPlatform/gcloud-java#authentication) and [project ID docs](https://github.com/GoogleCloudPlatform/gcloud-java#specifying-a-project-id).
-[`BigQueryExample`](https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/gcloud-java-examples/src/main/java/com/google/gcloud/examples/BigQueryExample.java) - A simple command line interface providing some of Cloud BigQuery's functionality
46
-
- Read more about using this application on the [`gcloud-java-examples` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/gcloud/examples/BigQueryExample.html).
47
45
-[`DatastoreExample`](https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/gcloud-java-examples/src/main/java/com/google/gcloud/examples/DatastoreExample.java) - A simple command line interface for the Cloud Datastore
48
46
- Read more about using this application on the [`gcloud-java-examples` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/gcloud/examples/DatastoreExample.html).
49
-
-[`ResourceManagerExample`](https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/gcloud-java-examples/src/main/java/com/google/gcloud/examples/ResourceManagerExample.java) - A simple command line interface providing some of Cloud Resource Manager's functionality
50
-
- Read more about using this application on the [`gcloud-java-examples` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/gcloud/examples/ResourceManagerExample.html).
51
47
-[`StorageExample`](https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/gcloud-java-examples/src/main/java/com/google/gcloud/examples/StorageExample.java) - A simple command line interface providing some of Cloud Storage's functionality
52
48
- Read more about using this application on the [`gcloud-java-examples` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/gcloud/examples/StorageExample.html).
49
+
-[`ResourceManagerExample`](https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/gcloud-java-examples/src/main/java/com/google/gcloud/examples/ResourceManagerExample.java) - A simple command line interface providing some of Cloud Resource Manager's functionality
50
+
- Read more about using this application on the [`gcloud-java-examples` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/gcloud/examples/ResourceManagerExample.html).
51
+
-[`BigQueryExample`](https://github.com/GoogleCloudPlatform/gcloud-java/blob/master/gcloud-java-examples/src/main/java/com/google/gcloud/examples/BigQueryExample.java) - A simple command line interface providing some of Cloud BigQuery's functionality
52
+
- Read more about using this application on the [`gcloud-java-examples` docs page](http://googlecloudplatform.github.io/gcloud-java/apidocs/?com/google/gcloud/examples/BigQueryExample.html).
53
53
54
54
Specifying a Project ID
55
55
-----------------------
@@ -109,51 +109,6 @@ Next, choose a method for authenticating API requests from within your project:
109
109
4. Google Cloud SDK credentials
110
110
5. Compute Engine credentials
111
111
112
-
Google Cloud BigQuery
113
-
----------------------
114
-
115
-
- [API Documentation][bigquery-api]
116
-
- [Official Documentation][cloud-bigquery-docs]
117
-
118
-
#### Preview
119
-
120
-
Here is a code snippet showing a simple usage example from within Compute/App Engine. Note that you
121
-
must [supply credentials](#authentication) and a project ID if running this snippet elsewhere.
while (loadJob.status().state() != JobStatus.State.DONE) {
146
-
Thread.sleep(1000L);
147
-
loadJob = bigquery.getJob(loadJob.jobId());
148
-
}
149
-
if (loadJob.status().error() != null) {
150
-
System.out.println("Job completed with errors");
151
-
} else {
152
-
System.out.println("Job succeeded");
153
-
}
154
-
}
155
-
```
156
-
157
112
Google Cloud Datastore
158
113
----------------------
159
114
@@ -194,6 +149,45 @@ if (entity == null) {
194
149
}
195
150
```
196
151
152
+
Google Cloud Storage
153
+
----------------------
154
+
155
+
- [API Documentation][storage-api]
156
+
- [Official Documentation][cloud-storage-docs]
157
+
158
+
*Follow the [activation instructions][cloud-storage-activation] to use the Google Cloud Storage API with your project.*
159
+
160
+
#### Preview
161
+
162
+
Here is a code snippet showing a simple usage example from within Compute/App Engine. Note that you must [supply credentials](#authentication) and a project ID if running this snippet elsewhere.
@@ -225,42 +219,48 @@ while (projectIterator.hasNext()) {
225
219
}
226
220
```
227
221
228
-
Google Cloud Storage
222
+
Google Cloud BigQuery
229
223
----------------------
230
224
231
-
- [API Documentation][storage-api]
232
-
- [Official Documentation][cloud-storage-docs]
233
-
234
-
*Follow the [activation instructions][cloud-storage-activation] to use the Google Cloud Storage API with your project.*
225
+
- [API Documentation][bigquery-api]
226
+
- [Official Documentation][cloud-bigquery-docs]
235
227
236
228
#### Preview
237
229
238
-
Here is a code snippet showing a simple usage example from within Compute/App Engine. Note that you must [supply credentials](#authentication) and a project ID if running this snippet elsewhere.
230
+
Here is a code snippet showing a simple usage example from within Compute/App Engine. Note that you
231
+
must [supply credentials](#authentication) and a project ID if running this snippet elsewhere.
0 commit comments