Skip to content

Commit 963c259

Browse files
authored
Release v1.0.12 (#119)
* Bump v1.0.11 to v1.0.12. * Bump 1.0.12-SNAPSHOT to 1.0.12. * Minor README cleanup.
1 parent 480f958 commit 963c259

File tree

12 files changed

+40
-35
lines changed

12 files changed

+40
-35
lines changed

README.md

Lines changed: 20 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,18 @@
1+
## Cloud SQL Socket Factory for JDBC drivers
12
[![Build
23
Status](https://travis-ci.org/GoogleCloudPlatform/cloud-sql-jdbc-socket-factory.svg?branch=master)](https://travis-ci.org/GoogleCloudPlatform/cloud-sql-jdbc-socket-factory)
3-
## Cloud SQL Socket Factory for JDBC drivers
44

55
The Cloud SQL Socket Factory is a library for the MySQL/Postgres JDBC drivers that allows a user
66
with the appropriate permissions to connect to a Cloud SQL database without having to deal with IP
77
whitelisting or SSL certificates manually.
88

99
## Instructions
1010

11-
This library is available
12-
13-
[Maven Central](http://search.maven.org/#artifactdetails%7Ccom.google.cloud.sql%7Cmysql-socket-factory%7C1.0.4%7Cjar).
11+
### Examples
1412

13+
For an examples of a simple application using Cloud SQL Socket Factory, please take a look at the
14+
projects found
15+
[here](https://github.com/GoogleCloudPlatform/java-docs-samples/tree/master/cloud-sql).
1516

1617
### Authentication
1718

@@ -29,13 +30,14 @@ gcloud auth application-default login
2930

3031
#### MySQL
3132

32-
**Note**: Use the correct version to match your JDBC driver:
33+
**Note**: Use your JDBC driver version to figure out which SocketFactory you should use. If you
34+
are unsure, it is recommended to use the latest version of `mysql-connector-java:8.x`.
3335

3436
| JDBC Driver Version | Cloud SQL Socket Factory Version |
3537
| -------------------------- | ---------------------------------------- |
36-
| mysql-connector-java:8.x | mysql-socket-factory-connector-j-8:1.0.11 |
37-
| mysql-connector-java:6.x | mysql-socket-factory-connector-j-6:1.0.11 |
38-
| mysql-connector-java:5.1.x | mysql-socket-factory:1.0.11 |
38+
| mysql-connector-java:8.x | mysql-socket-factory-connector-j-8:1.0.12 |
39+
| mysql-connector-java:6.x | mysql-socket-factory-connector-j-6:1.0.12 |
40+
| mysql-connector-java:5.1.x | mysql-socket-factory:1.0.12 |
3941

4042

4143
##### Maven
@@ -44,14 +46,14 @@ Include the following in the project's `pom.xml`:
4446
<dependency>
4547
    <groupId>com.google.cloud.sql</groupId>
4648
    <artifactId>mysql-socket-factory-connector-j-8</artifactId>
47-
    <version>1.0.11</version>
49+
    <version>1.0.12</version>
4850
</dependency>
4951
```
5052

51-
#### Gradle
53+
##### Gradle
5254
Include the following the project's `gradle.build`
5355
```gradle
54-
compile 'com.google.cloud.sql:mysql-socket-factory-connector-j-8:1.0.11'
56+
compile 'com.google.cloud.sql:mysql-socket-factory-connector-j-8:1.0.12'
5557
```
5658

5759
#### PostgreSQL
@@ -62,14 +64,14 @@ Include the following in the project's `pom.xml`:
6264
<dependency>
6365
    <groupId>com.google.cloud.sql</groupId>
6466
    <artifactId>postgres-socket-factory</artifactId>
65-
    <version>1.0.11</version>
67+
    <version>1.0.12</version>
6668
</dependency>
6769
```
6870

6971
#### Gradle
7072
Include the following the project's `gradle.build`
7173
```gradle
72-
compile 'com.google.cloud.sql:postgres-socket-factory:1.0.11'
74+
compile 'com.google.cloud.sql:postgres-socket-factory:1.0.12'
7375
```
7476

7577

@@ -114,7 +116,7 @@ jdbc:postgresql://google/<DATABASE_NAME>?cloudSqlInstance=<INSTANCE_CONNECTION_N
114116

115117
## Additional Information
116118

117-
### Specifying IP Type
119+
### Specifying IP Types
118120

119121
The `ipTypes` argument can be used to specify a comma delimited list of preferred IP types for
120122
connecting to a Cloud SQL instance. The argument `ipTypes=PRIVATE` will force the
@@ -123,7 +125,10 @@ SocketFactory to connect with an instance's associated private IP. Default value
123125

124126
### Firewall configuration
125127

126-
The Cloud SQL proxy establishes connections to Cloud SQL instances using port 3307. Applications that are protected by a firewall may need to be configured to allow outgoing connections on TCP port 3307. A connection blocked by a firewall typically results in an error stating connection failure (e.g. `com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure`).
128+
The Cloud SQL proxy establishes connections to Cloud SQL instances using port 3307. Applications
129+
that are protected by a firewall may need to be configured to allow outgoing connections on TCP port
130+
3307. A connection blocked by a firewall typically results in an error stating connection failure
131+
(e.g. `com.mysql.jdbc.exceptions.jdbc4.CommunicationsException: Communications link failure`).
127132

128133
### Connect with IntelliJ
129134

connector-j-5/pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<parent>
66
<groupId>com.google.cloud.sql</groupId>
77
<artifactId>jdbc-socket-factory-parent</artifactId>
8-
<version>1.0.12-SNAPSHOT</version>
8+
<version>1.0.12</version>
99
</parent>
1010
<artifactId>mysql-socket-factory</artifactId>
1111
<packaging>jar</packaging>
@@ -27,7 +27,7 @@
2727
<dependency>
2828
<groupId>com.google.cloud.sql</groupId>
2929
<artifactId>jdbc-socket-factory-core</artifactId>
30-
<version>1.0.12-SNAPSHOT</version>
30+
<version>1.0.12</version>
3131
</dependency>
3232
</dependencies>
3333
</project>

connector-j-6/pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<parent>
66
<groupId>com.google.cloud.sql</groupId>
77
<artifactId>jdbc-socket-factory-parent</artifactId>
8-
<version>1.0.12-SNAPSHOT</version>
8+
<version>1.0.12</version>
99
</parent>
1010
<artifactId>mysql-socket-factory-connector-j-6</artifactId>
1111
<packaging>jar</packaging>
@@ -27,7 +27,7 @@
2727
<dependency>
2828
<groupId>com.google.cloud.sql</groupId>
2929
<artifactId>jdbc-socket-factory-core</artifactId>
30-
<version>1.0.12-SNAPSHOT</version>
30+
<version>1.0.12</version>
3131
</dependency>
3232
</dependencies>
3333

connector-j-8/pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<parent>
66
<groupId>com.google.cloud.sql</groupId>
77
<artifactId>jdbc-socket-factory-parent</artifactId>
8-
<version>1.0.12-SNAPSHOT</version>
8+
<version>1.0.12</version>
99
</parent>
1010
<artifactId>mysql-socket-factory-connector-j-8</artifactId>
1111
<packaging>jar</packaging>
@@ -27,7 +27,7 @@
2727
<dependency>
2828
<groupId>com.google.cloud.sql</groupId>
2929
<artifactId>jdbc-socket-factory-core</artifactId>
30-
<version>1.0.12-SNAPSHOT</version>
30+
<version>1.0.12</version>
3131
</dependency>
3232
</dependencies>
3333

core/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<parent>
66
<groupId>com.google.cloud.sql</groupId>
77
<artifactId>jdbc-socket-factory-parent</artifactId>
8-
<version>1.0.12-SNAPSHOT</version>
8+
<version>1.0.12</version>
99
</parent>
1010
<artifactId>jdbc-socket-factory-core</artifactId>
1111
<packaging>jar</packaging>

examples/compute-engine/pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
<groupId>com.google.cloud.sql.example</groupId>
66
<artifactId>mysql-socket-factory-compute-engine</artifactId>
7-
<version>1.0.11</version>
7+
<version>1.0.12</version>
88
<build>
99
<plugins>
1010
<plugin>
@@ -37,7 +37,7 @@
3737
<dependency>
3838
<groupId>com.google.cloud.sql</groupId>
3939
<artifactId>mysql-socket-factory</artifactId>
40-
<version>1.0.11</version>
40+
<version>1.0.12</version>
4141
</dependency>
4242

4343
<dependency>

examples/getting-started/pom.xml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
<groupId>com.google.cloud.sql.example</groupId>
66
<artifactId>mysql-socket-factory-getting-started</artifactId>
7-
<version>1.0.11</version>
7+
<version>1.0.12</version>
88
<build>
99
<plugins>
1010
<plugin>
@@ -43,13 +43,13 @@
4343
<dependency>
4444
<groupId>com.google.cloud.sql</groupId>
4545
<artifactId>mysql-socket-factory</artifactId>
46-
<version>1.0.11</version>
46+
<version>1.0.12</version>
4747
</dependency>
4848

4949
<dependency>
5050
<groupId>com.google.cloud.sql</groupId>
5151
<artifactId>postgres-socket-factory</artifactId>
52-
<version>1.0.11</version>
52+
<version>1.0.12</version>
5353
</dependency>
5454

5555
<dependency>

examples/mysql/compute-engine/pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
<groupId>com.google.cloud.sql.example</groupId>
66
<artifactId>mysql-socket-factory-compute-engine</artifactId>
7-
<version>1.0.11</version>
7+
<version>1.0.12</version>
88
<build>
99
<plugins>
1010
<plugin>
@@ -37,7 +37,7 @@
3737
<dependency>
3838
<groupId>com.google.cloud.sql</groupId>
3939
<artifactId>mysql-socket-factory</artifactId>
40-
<version>1.0.11</version>
40+
<version>1.0.12</version>
4141
</dependency>
4242

4343
<dependency>

examples/postgres/appengine-standard-java8/pom.xml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@
6969
<dependency>
7070
<groupId>com.google.cloud.sql</groupId>
7171
<artifactId>postgres-socket-factory</artifactId>
72-
<version>1.0.11</version>
72+
<version>1.0.12</version>
7373
</dependency>
7474
<!-- [END dependencies] -->
7575
</dependencies>

examples/postgres/compute-engine/pom.xml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
<groupId>com.google.cloud.sql.example</groupId>
66
<artifactId>postgres-socket-factory-compute-engine</artifactId>
7-
<version>1.0.11</version>
7+
<version>1.0.12</version>
88
<build>
99
<plugins>
1010
<plugin>
@@ -37,7 +37,7 @@
3737
<dependency>
3838
<groupId>com.google.cloud.sql</groupId>
3939
<artifactId>postgres-socket-factory</artifactId>
40-
<version>1.0.11</version>
40+
<version>1.0.12</version>
4141
</dependency>
4242

4343
<dependency>

0 commit comments

Comments
 (0)