JarCastingDocumentation
See the wiki for CLC Java SDK getting-started and user guides.
SDK Installation
If you use Maven or Gradle, you can simply add the CLC SDK as a dependency.
Maven:
<dependencies>
<dependency>
<groupId>com.centurylink.cloud</groupId>
<artifactId>clc-java-sdk</artifactId>
<version>1.2.3</version>
</dependency>
</dependencies>
Gradle:
compile 'com.centurylink.cloud:clc-java-sdk:1.2.1'
SDK with spring adapter installation
Add spring clc sdk as dependency
Maven:
<dependencies>
<dependency>
<groupId>com.centurylink.cloud</groupId>
<artifactId>spring-clc-sdk</artifactId>
<version>1.2.3</version>
</dependency>
</dependencies>
Gradle:
compile 'com.centurylink.cloud:spring-clc-sdk:1.2.3'
Provide credentials and config
@Configuration
@EnableClcSdk
class MyConfig {
@Bean
public CredentialsProvider clcCredentialsProvider() {
return new StaticCredentialsProvider("john.doe", "strong_password");
}
@Bean
public SdkConfiguration clcSdkConfig() {
return new SdkConfigurationBuilder().build();
}
}
Then you can autowire necessary sdk services
@Autowired
ServerService serverService;
@Autowired
GroupService groupService;
Configuration
Please see the SDK configuration section for details and examples of how to configure the CLC SDK.
Example
This example shows some of the functionality supported by the CLC Java SDK.
import static com.centurylink.cloud.sdk.servers.services.domain.InfrastructureConfig.dataCenter;
...
ClcSdk sdk = new ClcSdk("user", "password");
ServerService serverService = sdk.serverService();
GroupService groupService = sdk.groupService();
serverService
.create(new CreateServerConfig()
.name("TCRT")
.type(STANDARD)
.group(Group.refByName()
.name(DEFAULT_GROUP)
.dataCenter(DE1_FRANKFURT)
)
.machine(new Machine()
.cpuCount(1)
.ram(3)
)
.template(Template.refByOs()
.dataCenter(DE_FRANKFURT)
.type(CENTOS)
.version("6")
.architecture(x86_64)
)
.network(new NetworkConfig()
.primaryDns("172.17.1.26")
.secondaryDns("172.17.1.27")
)
)
.waitUntilComplete();
Build Process
To build sources, you need to install Gradle 2.2.1 or later. To check out and build the CLC SDK source, issue the following commands:
$ git clone git@github.com:CenturyLinkCloud/clc-java-sdk.git
$ cd clc-java-sdk
$ gradle build
License
This project is licensed under the Apache License v2.0.
