Skip to content
This repository was archived by the owner on Sep 16, 2023. It is now read-only.

Commit 5d44d18

Browse files
authored
feat: release as beta (#52)
1 parent 6af3c47 commit 5d44d18

File tree

4 files changed

+112
-106
lines changed

4 files changed

+112
-106
lines changed

.repo-metadata.json

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,12 @@
22
"name": "iamcredentials",
33
"name_pretty": "IAM Service Account Credentials API",
44
"product_documentation": "https://cloud.google.com/iam/credentials/reference/rest/",
5-
"client_documentation": "https://googleapis.dev/java/google-cloud-clients/latest/index.html?com/google/cloud/asset/v1beta1/package-summary.html",
5+
"client_documentation": "https://googleapis.dev/java/google-cloud-iamcredentials/latest/index.html",
6+
"api_description": "creates short-lived, limited-privilege credentials for IAM service accounts.",
67
"issue_tracker": "https://issuetracker.google.com/issues/new?component=187161&template=0",
7-
"release_level": "alpha",
8+
"release_level": "beta",
89
"language": "java",
10+
"transport": "grpc",
911
"repo": "googleapis/java-iamcredentials",
1012
"repo_short": "java-iamcredentials",
1113
"distribution_name": "com.google.cloud:google-cloud-iamcredentials",

README.md

Lines changed: 103 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,52 @@
1-
Google Cloud Java Client for IAM Service Account Credentials API
2-
===================================================
1+
# Google IAM Service Account Credentials API Client for Java
32

4-
Java idiomatic client for [IAM Service Account Credentials API][product-overview].
3+
Java idiomatic client for [IAM Service Account Credentials API][product-docs].
54

6-
[![Kokoro CI](http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/master.svg)](http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/master.html)
7-
[![Maven](https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-iamcredentials.svg)](https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-iamcredentials.svg)
8-
[![Codacy Badge](https://api.codacy.com/project/badge/grade/9da006ad7c3a4fe1abd142e77c003917)](https://www.codacy.com/app/mziccard/google-cloud-java)
5+
[![Maven][maven-version-image]][maven-version-link]
6+
![Stability][stability-image]
97

108
- [Product Documentation][product-docs]
11-
- [Client Library Documentation][lib-docs]
9+
- [Client Library Documentation][javadocs]
1210

1311
> Note: This client is a work-in-progress, and may occasionally
1412
> make backwards-incompatible changes.
1513
16-
Quickstart
17-
----------
18-
If you are using Maven with a BOM, add this to your pom.xml file.
14+
## Quickstart
15+
16+
If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file
1917
```xml
2018
<dependencyManagement>
21-
<dependencies>
22-
<dependency>
23-
<groupId>com.google.cloud</groupId>
24-
<artifactId>libraries-bom</artifactId>
25-
<version>2.8.0</version>
26-
<type>pom</type>
27-
<scope>import</scope>
28-
</dependency>
29-
</dependencies>
19+
<dependencies>
20+
<dependency>
21+
<groupId>com.google.cloud</groupId>
22+
<artifactId>libraries-bom</artifactId>
23+
<version>3.4.0</version>
24+
<type>pom</type>
25+
<scope>import</scope>
26+
</dependency>
27+
</dependencies>
3028
</dependencyManagement>
3129

32-
<dependency>
33-
<groupId>com.google.cloud</groupId>
34-
<artifactId>google-cloud-iamcredentials</artifactId>
35-
</dependency>
30+
<dependencies>
31+
<dependency>
32+
<groupId>com.google.cloud</groupId>
33+
<artifactId>google-cloud-iamcredentials</artifactId>
34+
</dependency>
35+
</dependencies>
3636
```
3737

3838
[//]: # ({x-version-update-start:google-cloud-iamcredentials:released})
39-
If you are using Maven without a BOM, add this to your dependencies.
39+
40+
If you are using Maven without BOM, add this to your dependencies:
41+
4042
```xml
4143
<dependency>
4244
<groupId>com.google.cloud</groupId>
4345
<artifactId>google-cloud-iamcredentials</artifactId>
4446
<version>0.43.1-alpha</version>
4547
</dependency>
4648
```
49+
4750
If you are using Gradle, add this to your dependencies
4851
```Groovy
4952
compile 'com.google.cloud:google-cloud-iamcredentials:0.43.1-alpha'
@@ -54,66 +57,105 @@ libraryDependencies += "com.google.cloud" % "google-cloud-iamcredentials" % "0.4
5457
```
5558
[//]: # ({x-version-update-end})
5659

57-
Authentication
58-
--------------
60+
## Authentication
61+
62+
See the [Authentication][authentication] section in the base directory's README.
5963

60-
See the [Authentication](https://github.com/googleapis/google-cloud-java#authentication) section in the base directory's README.
64+
## Getting Started
6165

62-
About IAM Service Account Credentials API
63-
----------------------------
66+
### Prerequisites
6467

65-
Creates short-lived, limited-privilege credentials for IAM service accounts.
68+
You will need a [Google Cloud Platform Console][developer-console] project with the IAM Service Account Credentials API [API enabled][enable-api].
6669

67-
See the [IAM Service Account Credentials API client library docs][lib-docs] to learn how to use this IAM Service Account Credentials Client Library.
70+
[Follow these instructions][create-project] to get your project set up. You will also need to set up the local development environment by
71+
[installing the Google Cloud SDK][cloud-sdk] and running the following commands in command line:
72+
`gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
6873

69-
Getting Started
70-
---------------
71-
#### Prerequisites
72-
You will need a [Google Developers Console](https://console.developers.google.com/) project with the IAM Service Account Credentials API enabled. [Follow these instructions](https://cloud.google.com/resource-manager/docs/creating-managing-projects) to get your project set up. You will also need to set up the local development environment by [installing the Google Cloud SDK](https://cloud.google.com/sdk/) and running the following commands in command line: `gcloud auth login` and `gcloud config set project [YOUR PROJECT ID]`.
74+
### Installation and setup
7375

74-
#### Installation and setup
75-
You'll need to obtain the `google-cloud-iamcredentials` library. See the [Quickstart](#quickstart) section to add `google-cloud-iamcredentials` as a dependency in your code.
76+
You'll need to obtain the `google-cloud-iamcredentials` library. See the [Quickstart](#quickstart) section
77+
to add `google-cloud-iamcredentials` as a dependency in your code.
7678

77-
Troubleshooting
78-
---------------
79+
## About IAM Service Account Credentials API
7980

80-
To get help, follow the instructions in the [shared Troubleshooting document](https://github.com/googleapis/google-cloud-common/blob/master/troubleshooting/readme.md#troubleshooting).
8181

82-
Transport
83-
---------
84-
IAM Service Account Credentials Client uses gRPC for the transport layer.
82+
[IAM Service Account Credentials API][product-docs] creates short-lived, limited-privilege credentials for IAM service accounts.
8583

86-
Java Versions
87-
-------------
84+
See the [IAM Service Account Credentials API client library docs][javadocs] to learn how to
85+
use this IAM Service Account Credentials API Client Library.
86+
87+
88+
89+
90+
## Troubleshooting
91+
92+
To get help, follow the instructions in the [shared Troubleshooting document][troubleshooting].
93+
94+
## Transport
95+
96+
IAM Service Account Credentials API uses gRPC for the transport layer.
97+
98+
## Java Versions
8899

89100
Java 7 or above is required for using this client.
90101

91-
Versioning
92-
----------
102+
## Versioning
93103

94104
This library follows [Semantic Versioning](http://semver.org/).
95105

96-
It is currently in major version zero (``0.y.z``), which means that anything may change at any time and the public API should not be considered stable.
97106

98-
Contributing
99-
------------
107+
It is currently in major version zero (``0.y.z``), which means that anything may change at any time
108+
and the public API should not be considered stable.
109+
110+
111+
## Contributing
112+
100113

101114
Contributions to this library are always welcome and highly encouraged.
102115

103-
See `google-cloud`'s [CONTRIBUTING] documentation and the [shared documentation](https://github.com/googleapis/google-cloud-common/blob/master/contributing/readme.md#how-to-contribute-to-gcloud) for more information on how to get started.
116+
See [CONTRIBUTING][contributing] for more information how to get started.
117+
118+
Please note that this project is released with a Contributor Code of Conduct. By participating in
119+
this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more
120+
information.
104121

105-
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms. See [Code of Conduct][code-of-conduct] for more information.
122+
## License
106123

107-
License
108-
-------
124+
Apache 2.0 - See [LICENSE][license] for more information.
109125

110-
Apache 2.0 - See [LICENSE] for more information.
126+
## CI Status
111127

128+
Java Version | Status
129+
------------ | ------
130+
Java 7 | [![Kokoro CI][kokoro-badge-image-1]][kokoro-badge-link-1]
131+
Java 8 | [![Kokoro CI][kokoro-badge-image-2]][kokoro-badge-link-2]
132+
Java 8 OSX | [![Kokoro CI][kokoro-badge-image-3]][kokoro-badge-link-3]
133+
Java 8 Windows | [![Kokoro CI][kokoro-badge-image-4]][kokoro-badge-link-4]
134+
Java 11 | [![Kokoro CI][kokoro-badge-image-5]][kokoro-badge-link-5]
112135

113-
[CONTRIBUTING]:https://github.com/googleapis/google-cloud-java/blob/master/CONTRIBUTING.md
114-
[code-of-conduct]:https://github.com/googleapis/google-cloud-java/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
115-
[LICENSE]: https://github.com/googleapis/google-cloud-java/blob/master/LICENSE
116-
[cloud-platform]: https://cloud.google.com/
117-
[product-overview]: https://cloud.google.com/iam/credentials/reference/rest/
118136
[product-docs]: https://cloud.google.com/iam/credentials/reference/rest/
119-
[lib-docs]: https://googleapis.dev/java/google-cloud-clients/latest/index.html?com/google/cloud/iamcredentials/v1/package-summary.html
137+
[javadocs]: https://googleapis.dev/java/google-cloud-iamcredentials/latest/index.html
138+
[kokoro-badge-image-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java7.svg
139+
[kokoro-badge-link-1]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java7.html
140+
[kokoro-badge-image-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java8.svg
141+
[kokoro-badge-link-2]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java8.html
142+
[kokoro-badge-image-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java8-osx.svg
143+
[kokoro-badge-link-3]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java8-osx.html
144+
[kokoro-badge-image-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java8-win.svg
145+
[kokoro-badge-link-4]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java8-win.html
146+
[kokoro-badge-image-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java11.svg
147+
[kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-iamcredentials/java11.html
148+
[stability-image]: https://img.shields.io/badge/stability-beta-yellow
149+
[maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-iamcredentials.svg
150+
[maven-version-link]: https://search.maven.org/search?q=g:com.google.cloud%20AND%20a:google-cloud-iamcredentials&core=gav
151+
[authentication]: https://github.com/googleapis/google-cloud-java#authentication
152+
[developer-console]: https://console.developers.google.com/
153+
[create-project]: https://cloud.google.com/resource-manager/docs/creating-managing-projects
154+
[cloud-sdk]: https://cloud.google.com/sdk/
155+
[troubleshooting]: https://github.com/googleapis/google-cloud-common/blob/master/troubleshooting/readme.md#troubleshooting
156+
[contributing]: https://github.com/googleapis/java-iamcredentials/blob/master/CONTRIBUTING.md
157+
[code-of-conduct]: https://github.com/googleapis/java-iamcredentials/blob/master/CODE_OF_CONDUCT.md#contributor-code-of-conduct
158+
[license]: https://github.com/googleapis/java-iamcredentials/blob/master/LICENSE
159+
160+
[enable-api]: https://console.cloud.google.com/flows/enableapi?apiid=iamcredentials.googleapis.com
161+
[libraries-bom]: https://github.com/GoogleCloudPlatform/cloud-opensource-java/wiki/The-Google-Cloud-Platform-Libraries-BOM

synth.metadata

Lines changed: 2 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
{
2-
"updateTime": "2020-01-23T08:46:59.431242Z",
2+
"updateTime": "2020-01-23T21:58:34.134532Z",
33
"sources": [
44
{
55
"generator": {
@@ -12,9 +12,7 @@
1212
"git": {
1313
"name": "googleapis",
1414
"remote": "https://github.com/googleapis/googleapis.git",
15-
"sha": "8d16f76de065f530d395a4c7eabbf766d6a120fd",
16-
"internalRef": "291008516",
17-
"log": "8d16f76de065f530d395a4c7eabbf766d6a120fd\nGenerate Memcache v1beta2 API protos and gRPC ServiceConfig files\n\nPiperOrigin-RevId: 291008516\n\n3af1dabd93df9a9f17bf3624d3b875c11235360b\ngrafeas: Add containeranalysis default_host to Grafeas service\n\nPiperOrigin-RevId: 290965849\n\nbe2663fa95e31cba67d0cd62611a6674db9f74b7\nfix(google/maps/roads): add missing opening bracket\n\nPiperOrigin-RevId: 290964086\n\nfacc26550a0af0696e0534bc9cae9df14275aa7c\nUpdating v2 protos with the latest inline documentation (in comments) and adding a per-service .yaml file.\n\nPiperOrigin-RevId: 290952261\n\ncda99c1f7dc5e4ca9b1caeae1dc330838cbc1461\nChange api_name to 'asset' for v1p1beta1\n\nPiperOrigin-RevId: 290800639\n\n94e9e90c303a820ce40643d9129e7f0d2054e8a1\nAdds Google Maps Road service\n\nPiperOrigin-RevId: 290795667\n\na3b23dcb2eaecce98c600c7d009451bdec52dbda\nrpc: new message ErrorInfo, other comment updates\n\nPiperOrigin-RevId: 290781668\n\n26420ef4e46c37f193c0fbe53d6ebac481de460e\nAdd proto definition for Org Policy v1.\n\nPiperOrigin-RevId: 290771923\n\n7f0dab8177cf371ae019a082e2512de7ac102888\nPublish Routes Preferred API v1 service definitions.\n\nPiperOrigin-RevId: 290326986\n\nad6e508d0728e1d1bca6e3f328cd562718cb772d\nFix: Qualify resource type references with \"jobs.googleapis.com/\"\n\nPiperOrigin-RevId: 290285762\n\n58e770d568a2b78168ddc19a874178fee8265a9d\ncts client library\n\nPiperOrigin-RevId: 290146169\n\naf9daa4c3b4c4a8b7133b81588dd9ffd37270af2\nAdd more programming language options to public proto\n\nPiperOrigin-RevId: 290144091\n\nd9f2bbf2df301ef84641d4cec7c828736a0bd907\ntalent: add missing resource.proto dep to Bazel build target\n\nPiperOrigin-RevId: 290143164\n\n3b3968237451d027b42471cd28884a5a1faed6c7\nAnnotate Talent API.\nAdd gRPC service config for retry.\nUpdate bazel file with google.api.resource dependency.\n\nPiperOrigin-RevId: 290125172\n\n"
15+
"sha": "c2cdcd2b08ca35c5054268f6277ea04713c88e39"
1816
}
1917
},
2018
{
@@ -53,9 +51,6 @@
5351
{
5452
"path": ".github/release-please.yml"
5553
},
56-
{
57-
"path": ".gitignore"
58-
},
5954
{
6055
"path": ".kokoro/build.bat"
6156
},
@@ -221,12 +216,6 @@
221216
{
222217
"path": ".kokoro/trampoline.sh"
223218
},
224-
{
225-
"path": ".repo-metadata.json"
226-
},
227-
{
228-
"path": "CHANGELOG.md"
229-
},
230219
{
231220
"path": "CODE_OF_CONDUCT.md"
232221
},
@@ -236,18 +225,9 @@
236225
{
237226
"path": "LICENSE"
238227
},
239-
{
240-
"path": "README.md"
241-
},
242228
{
243229
"path": "codecov.yaml"
244230
},
245-
{
246-
"path": "google-cloud-iamcredentials-bom/pom.xml"
247-
},
248-
{
249-
"path": "google-cloud-iamcredentials/pom.xml"
250-
},
251231
{
252232
"path": "google-cloud-iamcredentials/src/main/java/com/google/cloud/iam/credentials/v1/IamCredentialsClient.java"
253233
},
@@ -278,9 +258,6 @@
278258
{
279259
"path": "google-cloud-iamcredentials/src/test/java/com/google/cloud/iam/credentials/v1/MockIAMCredentialsImpl.java"
280260
},
281-
{
282-
"path": "grpc-google-cloud-iamcredentials-v1/pom.xml"
283-
},
284261
{
285262
"path": "grpc-google-cloud-iamcredentials-v1/src/main/java/com/google/cloud/iam/credentials/v1/IAMCredentialsGrpc.java"
286263
},
@@ -290,12 +267,6 @@
290267
{
291268
"path": "license-checks.xml"
292269
},
293-
{
294-
"path": "pom.xml"
295-
},
296-
{
297-
"path": "proto-google-cloud-iamcredentials-v1/pom.xml"
298-
},
299270
{
300271
"path": "proto-google-cloud-iamcredentials-v1/src/main/java/com/google/cloud/iam/credentials/v1/GenerateAccessTokenRequest.java"
301272
},
@@ -361,15 +332,6 @@
361332
},
362333
{
363334
"path": "renovate.json"
364-
},
365-
{
366-
"path": "synth.metadata"
367-
},
368-
{
369-
"path": "synth.py"
370-
},
371-
{
372-
"path": "versions.txt"
373335
}
374336
]
375337
}

versions.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Format:
22
# module:released-version:current-version
33

4-
proto-google-cloud-iamcredentials-v1:0.43.1-alpha:0.43.2-alpha-SNAPSHOT
5-
grpc-google-cloud-iamcredentials-v1:0.43.1-alpha:0.43.2-alpha-SNAPSHOT
6-
google-cloud-iamcredentials:0.43.1-alpha:0.43.2-alpha-SNAPSHOT
4+
proto-google-cloud-iamcredentials-v1:0.43.1:0.43.2-SNAPSHOT
5+
grpc-google-cloud-iamcredentials-v1:0.43.1:0.43.2-SNAPSHOT
6+
google-cloud-iamcredentials:0.43.1:0.43.2-SNAPSHOT

0 commit comments

Comments
 (0)