github.com/containerd/containerd@v22.0.0-20200918172823-438c87b8e050+incompatible/api/services/diff/v1/diff.proto (about)

     1  syntax = "proto3";
     2  
     3  package containerd.services.diff.v1;
     4  
     5  import weak "gogoproto/gogo.proto";
     6  import "google/protobuf/any.proto";
     7  import "github.com/containerd/containerd/api/types/mount.proto";
     8  import "github.com/containerd/containerd/api/types/descriptor.proto";
     9  
    10  option go_package = "github.com/containerd/containerd/api/services/diff/v1;diff";
    11  
    12  // Diff service creates and applies diffs
    13  service Diff {
    14  	// Apply applies the content associated with the provided digests onto
    15  	// the provided mounts. Archive content will be extracted and
    16  	// decompressed if necessary.
    17  	rpc Apply(ApplyRequest) returns (ApplyResponse);
    18  
    19  	// Diff creates a diff between the given mounts and uploads the result
    20  	// to the content store.
    21  	rpc Diff(DiffRequest) returns (DiffResponse);
    22  }
    23  
    24  message ApplyRequest {
    25  	// Diff is the descriptor of the diff to be extracted
    26  	containerd.types.Descriptor diff = 1;
    27  
    28  	repeated containerd.types.Mount mounts = 2;
    29  
    30  	map<string, google.protobuf.Any> payloads = 3;
    31  }
    32  
    33  message ApplyResponse {
    34  	// Applied is the descriptor for the object which was applied.
    35  	// If the input was a compressed blob then the result will be
    36  	// the descriptor for the uncompressed blob.
    37  	containerd.types.Descriptor applied = 1;
    38  }
    39  
    40  message DiffRequest {
    41  	// Left are the mounts which represent the older copy
    42  	// in which is the base of the computed changes.
    43  	repeated containerd.types.Mount left = 1;
    44  
    45  	// Right are the mounts which represents the newer copy
    46  	// in which changes from the left were made into.
    47  	repeated containerd.types.Mount right = 2;
    48  
    49  	// MediaType is the media type descriptor for the created diff
    50  	// object
    51  	string media_type = 3;
    52  
    53  	// Ref identifies the pre-commit content store object. This
    54  	// reference can be used to get the status from the content store.
    55  	string ref = 4;
    56  
    57  	// Labels are the labels to apply to the generated content
    58  	// on content store commit.
    59  	map<string, string> labels = 5;
    60  }
    61  
    62  message DiffResponse {
    63  	// Diff is the descriptor of the diff which can be applied
    64  	containerd.types.Descriptor diff = 3;
    65  }