exportlayer.go 2.1 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677
  1. package wclayer
  2. import (
  3. "io/ioutil"
  4. "os"
  5. "github.com/Microsoft/go-winio"
  6. "github.com/Microsoft/hcsshim/internal/hcserror"
  7. "github.com/sirupsen/logrus"
  8. )
  9. // ExportLayer will create a folder at exportFolderPath and fill that folder with
  10. // the transport format version of the layer identified by layerId. This transport
  11. // format includes any metadata required for later importing the layer (using
  12. // ImportLayer), and requires the full list of parent layer paths in order to
  13. // perform the export.
  14. func ExportLayer(path string, exportFolderPath string, parentLayerPaths []string) (err error) {
  15. title := "hcsshim::ExportLayer"
  16. fields := logrus.Fields{
  17. "path": path,
  18. "exportFolderPath": exportFolderPath,
  19. }
  20. logrus.WithFields(fields).Debug(title)
  21. defer func() {
  22. if err != nil {
  23. fields[logrus.ErrorKey] = err
  24. logrus.WithFields(fields).Error(err)
  25. } else {
  26. logrus.WithFields(fields).Debug(title + " - succeeded")
  27. }
  28. }()
  29. // Generate layer descriptors
  30. layers, err := layerPathsToDescriptors(parentLayerPaths)
  31. if err != nil {
  32. return err
  33. }
  34. err = exportLayer(&stdDriverInfo, path, exportFolderPath, layers)
  35. if err != nil {
  36. return hcserror.New(err, title+" - failed", "")
  37. }
  38. return nil
  39. }
  40. type LayerReader interface {
  41. Next() (string, int64, *winio.FileBasicInfo, error)
  42. Read(b []byte) (int, error)
  43. Close() error
  44. }
  45. // NewLayerReader returns a new layer reader for reading the contents of an on-disk layer.
  46. // The caller must have taken the SeBackupPrivilege privilege
  47. // to call this and any methods on the resulting LayerReader.
  48. func NewLayerReader(path string, parentLayerPaths []string) (LayerReader, error) {
  49. exportPath, err := ioutil.TempDir("", "hcs")
  50. if err != nil {
  51. return nil, err
  52. }
  53. err = ExportLayer(path, exportPath, parentLayerPaths)
  54. if err != nil {
  55. os.RemoveAll(exportPath)
  56. return nil, err
  57. }
  58. return &legacyLayerReaderWrapper{newLegacyLayerReader(exportPath)}, nil
  59. }
  60. type legacyLayerReaderWrapper struct {
  61. *legacyLayerReader
  62. }
  63. func (r *legacyLayerReaderWrapper) Close() error {
  64. err := r.legacyLayerReader.Close()
  65. os.RemoveAll(r.root)
  66. return err
  67. }