jonesbusy / oras-java

Apache License 2.0
2 stars 1 forks source link

ORAS Java

[!WARNING] The Oras Java SDK is currently in alpha state.

It's configuration and APIs might change in future releases

ORAS Logo

OCI Registry as Storage enables libraries to push OCI Artifacts to OCI Conformant registries. This is a Java SDK for Java developers to empower them to do this in their applications.

Examples

Push an Artifact

Path artifact = Path.of("pom.xml");
Registry registry = Registry.Builder.builder()
        .withInsecure(true)
        .build();
Manifest manifest = registry.pushArtifact(ContainerRef.parse("localhost:5000/hello:v1"), artifact);

Pull an Artifact

registry.pullArtifact(ContainerRef.parse("localhost:5000/hello:v1"), Path.of("folder"));

Deploy to GitHub Packages

This is temporary until published to Maven Central with a proper workflow.

The maven resolver must be switched to wagon to deploy to GitHub Packages.

mvn -Dmaven.resolver.transport=wagon -DskipTests -Poras-java clean deploy

Code of Conduct

Please note that this project has adopted the CNCF Code of Conduct. Please follow it in all your interactions with the project members and users.

License

This code is licensed under the Apache 2.0 LICENSE.