gcsfs.go 28 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012
  1. // Copyright (C) 2019-2023 Nicola Murino
  2. //
  3. // This program is free software: you can redistribute it and/or modify
  4. // it under the terms of the GNU Affero General Public License as published
  5. // by the Free Software Foundation, version 3.
  6. //
  7. // This program is distributed in the hope that it will be useful,
  8. // but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. // GNU Affero General Public License for more details.
  11. //
  12. // You should have received a copy of the GNU Affero General Public License
  13. // along with this program. If not, see <https://www.gnu.org/licenses/>.
  14. //go:build !nogcs
  15. // +build !nogcs
  16. package vfs
  17. import (
  18. "context"
  19. "fmt"
  20. "io"
  21. "mime"
  22. "net/http"
  23. "os"
  24. "path"
  25. "path/filepath"
  26. "strings"
  27. "time"
  28. "cloud.google.com/go/storage"
  29. "github.com/eikenb/pipeat"
  30. "github.com/pkg/sftp"
  31. "github.com/rs/xid"
  32. "google.golang.org/api/googleapi"
  33. "google.golang.org/api/iterator"
  34. "google.golang.org/api/option"
  35. "github.com/drakkan/sftpgo/v2/internal/logger"
  36. "github.com/drakkan/sftpgo/v2/internal/metric"
  37. "github.com/drakkan/sftpgo/v2/internal/plugin"
  38. "github.com/drakkan/sftpgo/v2/internal/util"
  39. "github.com/drakkan/sftpgo/v2/internal/version"
  40. )
  41. const (
  42. defaultGCSPageSize = 5000
  43. )
  44. var (
  45. gcsDefaultFieldsSelection = []string{"Name", "Size", "Deleted", "Updated", "ContentType"}
  46. )
  47. // GCSFs is a Fs implementation for Google Cloud Storage.
  48. type GCSFs struct {
  49. connectionID string
  50. localTempDir string
  51. // if not empty this fs is mouted as virtual folder in the specified path
  52. mountPath string
  53. config *GCSFsConfig
  54. svc *storage.Client
  55. ctxTimeout time.Duration
  56. ctxLongTimeout time.Duration
  57. }
  58. func init() {
  59. version.AddFeature("+gcs")
  60. }
  61. // NewGCSFs returns an GCSFs object that allows to interact with Google Cloud Storage
  62. func NewGCSFs(connectionID, localTempDir, mountPath string, config GCSFsConfig) (Fs, error) {
  63. if localTempDir == "" {
  64. localTempDir = getLocalTempDir()
  65. }
  66. var err error
  67. fs := &GCSFs{
  68. connectionID: connectionID,
  69. localTempDir: localTempDir,
  70. mountPath: getMountPath(mountPath),
  71. config: &config,
  72. ctxTimeout: 30 * time.Second,
  73. ctxLongTimeout: 300 * time.Second,
  74. }
  75. if err = fs.config.validate(); err != nil {
  76. return fs, err
  77. }
  78. ctx := context.Background()
  79. if fs.config.AutomaticCredentials > 0 {
  80. fs.svc, err = storage.NewClient(ctx)
  81. } else {
  82. err = fs.config.Credentials.TryDecrypt()
  83. if err != nil {
  84. return fs, err
  85. }
  86. fs.svc, err = storage.NewClient(ctx, option.WithCredentialsJSON([]byte(fs.config.Credentials.GetPayload())))
  87. }
  88. return fs, err
  89. }
  90. // Name returns the name for the Fs implementation
  91. func (fs *GCSFs) Name() string {
  92. return fmt.Sprintf("%s bucket %q", gcsfsName, fs.config.Bucket)
  93. }
  94. // ConnectionID returns the connection ID associated to this Fs implementation
  95. func (fs *GCSFs) ConnectionID() string {
  96. return fs.connectionID
  97. }
  98. // Stat returns a FileInfo describing the named file
  99. func (fs *GCSFs) Stat(name string) (os.FileInfo, error) {
  100. if name == "" || name == "/" || name == "." {
  101. return updateFileInfoModTime(fs.getStorageID(), name, NewFileInfo(name, true, 0, time.Unix(0, 0), false))
  102. }
  103. if fs.config.KeyPrefix == name+"/" {
  104. return updateFileInfoModTime(fs.getStorageID(), name, NewFileInfo(name, true, 0, time.Unix(0, 0), false))
  105. }
  106. return fs.getObjectStat(name)
  107. }
  108. // Lstat returns a FileInfo describing the named file
  109. func (fs *GCSFs) Lstat(name string) (os.FileInfo, error) {
  110. return fs.Stat(name)
  111. }
  112. // Open opens the named file for reading
  113. func (fs *GCSFs) Open(name string, offset int64) (File, *PipeReader, func(), error) {
  114. r, w, err := pipeat.PipeInDir(fs.localTempDir)
  115. if err != nil {
  116. return nil, nil, nil, err
  117. }
  118. p := NewPipeReader(r)
  119. if readMetadata > 0 {
  120. attrs, err := fs.headObject(name)
  121. if err != nil {
  122. r.Close()
  123. w.Close()
  124. return nil, nil, nil, err
  125. }
  126. p.setMetadata(attrs.Metadata)
  127. }
  128. bkt := fs.svc.Bucket(fs.config.Bucket)
  129. obj := bkt.Object(name)
  130. ctx, cancelFn := context.WithCancel(context.Background())
  131. objectReader, err := obj.NewRangeReader(ctx, offset, -1)
  132. if err == nil && offset > 0 && objectReader.Attrs.ContentEncoding == "gzip" {
  133. err = fmt.Errorf("range request is not possible for gzip content encoding, requested offset %d", offset)
  134. objectReader.Close()
  135. }
  136. if err != nil {
  137. r.Close()
  138. w.Close()
  139. cancelFn()
  140. return nil, nil, nil, err
  141. }
  142. go func() {
  143. defer cancelFn()
  144. defer objectReader.Close()
  145. n, err := io.Copy(w, objectReader)
  146. w.CloseWithError(err) //nolint:errcheck
  147. fsLog(fs, logger.LevelDebug, "download completed, path: %q size: %v, err: %+v", name, n, err)
  148. metric.GCSTransferCompleted(n, 1, err)
  149. }()
  150. return nil, p, cancelFn, nil
  151. }
  152. // Create creates or opens the named file for writing
  153. func (fs *GCSFs) Create(name string, flag, checks int) (File, PipeWriter, func(), error) {
  154. if checks&CheckParentDir != 0 {
  155. _, err := fs.Stat(path.Dir(name))
  156. if err != nil {
  157. return nil, nil, nil, err
  158. }
  159. }
  160. r, w, err := pipeat.PipeInDir(fs.localTempDir)
  161. if err != nil {
  162. return nil, nil, nil, err
  163. }
  164. var partialFileName string
  165. var attrs *storage.ObjectAttrs
  166. var statErr error
  167. bkt := fs.svc.Bucket(fs.config.Bucket)
  168. obj := bkt.Object(name)
  169. if flag == -1 {
  170. obj = obj.If(storage.Conditions{DoesNotExist: true})
  171. } else {
  172. attrs, statErr = fs.headObject(name)
  173. if statErr == nil {
  174. obj = obj.If(storage.Conditions{GenerationMatch: attrs.Generation})
  175. } else if fs.IsNotExist(statErr) {
  176. obj = obj.If(storage.Conditions{DoesNotExist: true})
  177. } else {
  178. fsLog(fs, logger.LevelWarn, "unable to set precondition for %q, stat err: %v", name, statErr)
  179. }
  180. }
  181. ctx, cancelFn := context.WithCancel(context.Background())
  182. var p PipeWriter
  183. var objectWriter *storage.Writer
  184. if checks&CheckResume != 0 {
  185. if statErr != nil {
  186. cancelFn()
  187. r.Close()
  188. w.Close()
  189. return nil, nil, nil, fmt.Errorf("unable to resume %q stat error: %w", name, statErr)
  190. }
  191. p = newPipeWriterAtOffset(w, attrs.Size)
  192. partialFileName = fs.getTempObject(name)
  193. partialObj := bkt.Object(partialFileName)
  194. partialObj = partialObj.If(storage.Conditions{DoesNotExist: true})
  195. objectWriter = partialObj.NewWriter(ctx)
  196. } else {
  197. p = NewPipeWriter(w)
  198. objectWriter = obj.NewWriter(ctx)
  199. }
  200. if fs.config.UploadPartSize > 0 {
  201. objectWriter.ChunkSize = int(fs.config.UploadPartSize) * 1024 * 1024
  202. }
  203. if fs.config.UploadPartMaxTime > 0 {
  204. objectWriter.ChunkRetryDeadline = time.Duration(fs.config.UploadPartMaxTime) * time.Second
  205. }
  206. fs.setWriterAttrs(objectWriter, flag, name)
  207. go func() {
  208. defer cancelFn()
  209. n, err := io.Copy(objectWriter, r)
  210. closeErr := objectWriter.Close()
  211. if err == nil {
  212. err = closeErr
  213. }
  214. if err == nil && partialFileName != "" {
  215. partialObject := bkt.Object(partialFileName)
  216. partialObject = partialObject.If(storage.Conditions{GenerationMatch: objectWriter.Attrs().Generation})
  217. err = fs.composeObjects(ctx, obj, partialObject)
  218. }
  219. r.CloseWithError(err) //nolint:errcheck
  220. p.Done(err)
  221. fsLog(fs, logger.LevelDebug, "upload completed, path: %q, acl: %q, readed bytes: %v, err: %+v",
  222. name, fs.config.ACL, n, err)
  223. metric.GCSTransferCompleted(n, 0, err)
  224. }()
  225. if uploadMode&8 != 0 {
  226. return nil, p, nil, nil
  227. }
  228. return nil, p, cancelFn, nil
  229. }
  230. // Rename renames (moves) source to target.
  231. func (fs *GCSFs) Rename(source, target string) (int, int64, error) {
  232. if source == target {
  233. return -1, -1, nil
  234. }
  235. _, err := fs.Stat(path.Dir(target))
  236. if err != nil {
  237. return -1, -1, err
  238. }
  239. fi, err := fs.getObjectStat(source)
  240. if err != nil {
  241. return -1, -1, err
  242. }
  243. return fs.renameInternal(source, target, fi)
  244. }
  245. // Remove removes the named file or (empty) directory.
  246. func (fs *GCSFs) Remove(name string, isDir bool) error {
  247. if isDir {
  248. hasContents, err := fs.hasContents(name)
  249. if err != nil {
  250. return err
  251. }
  252. if hasContents {
  253. return fmt.Errorf("cannot remove non empty directory: %q", name)
  254. }
  255. if !strings.HasSuffix(name, "/") {
  256. name += "/"
  257. }
  258. }
  259. obj := fs.svc.Bucket(fs.config.Bucket).Object(name)
  260. attrs, statErr := fs.headObject(name)
  261. if statErr == nil {
  262. obj = obj.If(storage.Conditions{GenerationMatch: attrs.Generation})
  263. } else {
  264. fsLog(fs, logger.LevelWarn, "unable to set precondition for deleting %q, stat err: %v",
  265. name, statErr)
  266. }
  267. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxTimeout))
  268. defer cancelFn()
  269. err := obj.Delete(ctx)
  270. if isDir && fs.IsNotExist(err) {
  271. // we can have directories without a trailing "/" (created using v2.1.0 and before)
  272. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxTimeout))
  273. defer cancelFn()
  274. err = fs.svc.Bucket(fs.config.Bucket).Object(strings.TrimSuffix(name, "/")).Delete(ctx)
  275. }
  276. metric.GCSDeleteObjectCompleted(err)
  277. if plugin.Handler.HasMetadater() && err == nil && !isDir {
  278. if errMetadata := plugin.Handler.RemoveMetadata(fs.getStorageID(), ensureAbsPath(name)); errMetadata != nil {
  279. fsLog(fs, logger.LevelWarn, "unable to remove metadata for path %q: %+v", name, errMetadata)
  280. }
  281. }
  282. return err
  283. }
  284. // Mkdir creates a new directory with the specified name and default permissions
  285. func (fs *GCSFs) Mkdir(name string) error {
  286. _, err := fs.Stat(name)
  287. if !fs.IsNotExist(err) {
  288. return err
  289. }
  290. return fs.mkdirInternal(name)
  291. }
  292. // Symlink creates source as a symbolic link to target.
  293. func (*GCSFs) Symlink(_, _ string) error {
  294. return ErrVfsUnsupported
  295. }
  296. // Readlink returns the destination of the named symbolic link
  297. func (*GCSFs) Readlink(_ string) (string, error) {
  298. return "", ErrVfsUnsupported
  299. }
  300. // Chown changes the numeric uid and gid of the named file.
  301. func (*GCSFs) Chown(_ string, _ int, _ int) error {
  302. return ErrVfsUnsupported
  303. }
  304. // Chmod changes the mode of the named file to mode.
  305. func (*GCSFs) Chmod(_ string, _ os.FileMode) error {
  306. return ErrVfsUnsupported
  307. }
  308. // Chtimes changes the access and modification times of the named file.
  309. func (fs *GCSFs) Chtimes(name string, _, mtime time.Time, isUploading bool) error {
  310. if !plugin.Handler.HasMetadater() {
  311. return ErrVfsUnsupported
  312. }
  313. if !isUploading {
  314. info, err := fs.Stat(name)
  315. if err != nil {
  316. return err
  317. }
  318. if info.IsDir() {
  319. return ErrVfsUnsupported
  320. }
  321. }
  322. return plugin.Handler.SetModificationTime(fs.getStorageID(), ensureAbsPath(name),
  323. util.GetTimeAsMsSinceEpoch(mtime))
  324. }
  325. // Truncate changes the size of the named file.
  326. // Truncate by path is not supported, while truncating an opened
  327. // file is handled inside base transfer
  328. func (*GCSFs) Truncate(_ string, _ int64) error {
  329. return ErrVfsUnsupported
  330. }
  331. // ReadDir reads the directory named by dirname and returns
  332. // a list of directory entries.
  333. func (fs *GCSFs) ReadDir(dirname string) ([]os.FileInfo, error) {
  334. var result []os.FileInfo
  335. // dirname must be already cleaned
  336. prefix := fs.getPrefix(dirname)
  337. query := &storage.Query{Prefix: prefix, Delimiter: "/"}
  338. err := query.SetAttrSelection(gcsDefaultFieldsSelection)
  339. if err != nil {
  340. return nil, err
  341. }
  342. modTimes, err := getFolderModTimes(fs.getStorageID(), dirname)
  343. if err != nil {
  344. return result, err
  345. }
  346. prefixes := make(map[string]bool)
  347. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxLongTimeout))
  348. defer cancelFn()
  349. bkt := fs.svc.Bucket(fs.config.Bucket)
  350. it := bkt.Objects(ctx, query)
  351. pager := iterator.NewPager(it, defaultGCSPageSize, "")
  352. for {
  353. var objects []*storage.ObjectAttrs
  354. pageToken, err := pager.NextPage(&objects)
  355. if err != nil {
  356. metric.GCSListObjectsCompleted(err)
  357. return result, err
  358. }
  359. for _, attrs := range objects {
  360. if attrs.Prefix != "" {
  361. name, _ := fs.resolve(attrs.Prefix, prefix, attrs.ContentType)
  362. if name == "" {
  363. continue
  364. }
  365. if _, ok := prefixes[name]; ok {
  366. continue
  367. }
  368. result = append(result, NewFileInfo(name, true, 0, time.Unix(0, 0), false))
  369. prefixes[name] = true
  370. } else {
  371. name, isDir := fs.resolve(attrs.Name, prefix, attrs.ContentType)
  372. if name == "" {
  373. continue
  374. }
  375. if !attrs.Deleted.IsZero() {
  376. continue
  377. }
  378. if isDir {
  379. // check if the dir is already included, it will be sent as blob prefix if it contains at least one item
  380. if _, ok := prefixes[name]; ok {
  381. continue
  382. }
  383. prefixes[name] = true
  384. }
  385. modTime := attrs.Updated
  386. if t, ok := modTimes[name]; ok {
  387. modTime = util.GetTimeFromMsecSinceEpoch(t)
  388. }
  389. result = append(result, NewFileInfo(name, isDir, attrs.Size, modTime, false))
  390. }
  391. }
  392. objects = nil
  393. if pageToken == "" {
  394. break
  395. }
  396. }
  397. metric.GCSListObjectsCompleted(nil)
  398. return result, nil
  399. }
  400. // IsUploadResumeSupported returns true if resuming uploads is supported.
  401. // Resuming uploads is not supported on GCS
  402. func (*GCSFs) IsUploadResumeSupported() bool {
  403. return false
  404. }
  405. // IsConditionalUploadResumeSupported returns if resuming uploads is supported
  406. // for the specified size
  407. func (*GCSFs) IsConditionalUploadResumeSupported(_ int64) bool {
  408. return true
  409. }
  410. // IsAtomicUploadSupported returns true if atomic upload is supported.
  411. // S3 uploads are already atomic, we don't need to upload to a temporary
  412. // file
  413. func (*GCSFs) IsAtomicUploadSupported() bool {
  414. return false
  415. }
  416. // IsNotExist returns a boolean indicating whether the error is known to
  417. // report that a file or directory does not exist
  418. func (*GCSFs) IsNotExist(err error) bool {
  419. if err == nil {
  420. return false
  421. }
  422. if err == storage.ErrObjectNotExist || err == storage.ErrBucketNotExist {
  423. return true
  424. }
  425. if e, ok := err.(*googleapi.Error); ok {
  426. if e.Code == http.StatusNotFound {
  427. return true
  428. }
  429. }
  430. return false
  431. }
  432. // IsPermission returns a boolean indicating whether the error is known to
  433. // report that permission is denied.
  434. func (*GCSFs) IsPermission(err error) bool {
  435. if err == nil {
  436. return false
  437. }
  438. if e, ok := err.(*googleapi.Error); ok {
  439. if e.Code == http.StatusForbidden || e.Code == http.StatusUnauthorized {
  440. return true
  441. }
  442. }
  443. return false
  444. }
  445. // IsNotSupported returns true if the error indicate an unsupported operation
  446. func (*GCSFs) IsNotSupported(err error) bool {
  447. if err == nil {
  448. return false
  449. }
  450. return err == ErrVfsUnsupported
  451. }
  452. // CheckRootPath creates the specified local root directory if it does not exists
  453. func (fs *GCSFs) CheckRootPath(username string, uid int, gid int) bool {
  454. // we need a local directory for temporary files
  455. osFs := NewOsFs(fs.ConnectionID(), fs.localTempDir, "", nil)
  456. return osFs.CheckRootPath(username, uid, gid)
  457. }
  458. // ScanRootDirContents returns the number of files contained in the bucket,
  459. // and their size
  460. func (fs *GCSFs) ScanRootDirContents() (int, int64, error) {
  461. return fs.GetDirSize(fs.config.KeyPrefix)
  462. }
  463. func (fs *GCSFs) getFileNamesInPrefix(fsPrefix string) (map[string]bool, error) {
  464. fileNames := make(map[string]bool)
  465. prefix := ""
  466. if fsPrefix != "/" {
  467. prefix = strings.TrimPrefix(fsPrefix, "/")
  468. }
  469. query := &storage.Query{
  470. Prefix: prefix,
  471. Delimiter: "/",
  472. }
  473. err := query.SetAttrSelection(gcsDefaultFieldsSelection)
  474. if err != nil {
  475. return fileNames, err
  476. }
  477. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxLongTimeout))
  478. defer cancelFn()
  479. bkt := fs.svc.Bucket(fs.config.Bucket)
  480. it := bkt.Objects(ctx, query)
  481. pager := iterator.NewPager(it, defaultGCSPageSize, "")
  482. for {
  483. var objects []*storage.ObjectAttrs
  484. pageToken, err := pager.NextPage(&objects)
  485. if err != nil {
  486. metric.GCSListObjectsCompleted(err)
  487. return fileNames, err
  488. }
  489. for _, attrs := range objects {
  490. if !attrs.Deleted.IsZero() {
  491. continue
  492. }
  493. if attrs.Prefix == "" {
  494. name, isDir := fs.resolve(attrs.Name, prefix, attrs.ContentType)
  495. if name == "" {
  496. continue
  497. }
  498. if isDir {
  499. continue
  500. }
  501. fileNames[name] = true
  502. }
  503. }
  504. objects = nil
  505. if pageToken == "" {
  506. break
  507. }
  508. }
  509. metric.GCSListObjectsCompleted(nil)
  510. return fileNames, nil
  511. }
  512. // CheckMetadata checks the metadata consistency
  513. func (fs *GCSFs) CheckMetadata() error {
  514. return fsMetadataCheck(fs, fs.getStorageID(), fs.config.KeyPrefix)
  515. }
  516. // GetDirSize returns the number of files and the size for a folder
  517. // including any subfolders
  518. func (fs *GCSFs) GetDirSize(dirname string) (int, int64, error) {
  519. prefix := fs.getPrefix(dirname)
  520. numFiles := 0
  521. size := int64(0)
  522. query := &storage.Query{Prefix: prefix}
  523. err := query.SetAttrSelection(gcsDefaultFieldsSelection)
  524. if err != nil {
  525. return numFiles, size, err
  526. }
  527. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxLongTimeout))
  528. defer cancelFn()
  529. bkt := fs.svc.Bucket(fs.config.Bucket)
  530. it := bkt.Objects(ctx, query)
  531. pager := iterator.NewPager(it, defaultGCSPageSize, "")
  532. for {
  533. var objects []*storage.ObjectAttrs
  534. pageToken, err := pager.NextPage(&objects)
  535. if err != nil {
  536. metric.GCSListObjectsCompleted(err)
  537. return numFiles, size, err
  538. }
  539. for _, attrs := range objects {
  540. if !attrs.Deleted.IsZero() {
  541. continue
  542. }
  543. isDir := strings.HasSuffix(attrs.Name, "/") || attrs.ContentType == dirMimeType
  544. if isDir && attrs.Size == 0 {
  545. continue
  546. }
  547. numFiles++
  548. size += attrs.Size
  549. if numFiles%1000 == 0 {
  550. fsLog(fs, logger.LevelDebug, "dirname %q scan in progress, files: %d, size: %d", dirname, numFiles, size)
  551. }
  552. }
  553. objects = nil
  554. if pageToken == "" {
  555. break
  556. }
  557. }
  558. metric.GCSListObjectsCompleted(nil)
  559. return numFiles, size, err
  560. }
  561. // GetAtomicUploadPath returns the path to use for an atomic upload.
  562. // GCS uploads are already atomic, we never call this method for GCS
  563. func (*GCSFs) GetAtomicUploadPath(_ string) string {
  564. return ""
  565. }
  566. // GetRelativePath returns the path for a file relative to the user's home dir.
  567. // This is the path as seen by SFTPGo users
  568. func (fs *GCSFs) GetRelativePath(name string) string {
  569. rel := path.Clean(name)
  570. if rel == "." {
  571. rel = ""
  572. }
  573. if !path.IsAbs(rel) {
  574. rel = "/" + rel
  575. }
  576. if fs.config.KeyPrefix != "" {
  577. if !strings.HasPrefix(rel, "/"+fs.config.KeyPrefix) {
  578. rel = "/"
  579. }
  580. rel = path.Clean("/" + strings.TrimPrefix(rel, "/"+fs.config.KeyPrefix))
  581. }
  582. if fs.mountPath != "" {
  583. rel = path.Join(fs.mountPath, rel)
  584. }
  585. return rel
  586. }
  587. // Walk walks the file tree rooted at root, calling walkFn for each file or
  588. // directory in the tree, including root
  589. func (fs *GCSFs) Walk(root string, walkFn filepath.WalkFunc) error {
  590. prefix := fs.getPrefix(root)
  591. query := &storage.Query{Prefix: prefix}
  592. err := query.SetAttrSelection(gcsDefaultFieldsSelection)
  593. if err != nil {
  594. walkFn(root, nil, err) //nolint:errcheck
  595. return err
  596. }
  597. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxLongTimeout))
  598. defer cancelFn()
  599. bkt := fs.svc.Bucket(fs.config.Bucket)
  600. it := bkt.Objects(ctx, query)
  601. pager := iterator.NewPager(it, defaultGCSPageSize, "")
  602. for {
  603. var objects []*storage.ObjectAttrs
  604. pageToken, err := pager.NextPage(&objects)
  605. if err != nil {
  606. walkFn(root, nil, err) //nolint:errcheck
  607. metric.GCSListObjectsCompleted(err)
  608. return err
  609. }
  610. for _, attrs := range objects {
  611. if !attrs.Deleted.IsZero() {
  612. continue
  613. }
  614. name, isDir := fs.resolve(attrs.Name, prefix, attrs.ContentType)
  615. if name == "" {
  616. continue
  617. }
  618. err = walkFn(attrs.Name, NewFileInfo(name, isDir, attrs.Size, attrs.Updated, false), nil)
  619. if err != nil {
  620. return err
  621. }
  622. }
  623. objects = nil
  624. if pageToken == "" {
  625. break
  626. }
  627. }
  628. walkFn(root, NewFileInfo(root, true, 0, time.Unix(0, 0), false), err) //nolint:errcheck
  629. metric.GCSListObjectsCompleted(err)
  630. return err
  631. }
  632. // Join joins any number of path elements into a single path
  633. func (*GCSFs) Join(elem ...string) string {
  634. return strings.TrimPrefix(path.Join(elem...), "/")
  635. }
  636. // HasVirtualFolders returns true if folders are emulated
  637. func (GCSFs) HasVirtualFolders() bool {
  638. return true
  639. }
  640. // ResolvePath returns the matching filesystem path for the specified virtual path
  641. func (fs *GCSFs) ResolvePath(virtualPath string) (string, error) {
  642. if fs.mountPath != "" {
  643. virtualPath = strings.TrimPrefix(virtualPath, fs.mountPath)
  644. }
  645. if !path.IsAbs(virtualPath) {
  646. virtualPath = path.Clean("/" + virtualPath)
  647. }
  648. return fs.Join(fs.config.KeyPrefix, strings.TrimPrefix(virtualPath, "/")), nil
  649. }
  650. // CopyFile implements the FsFileCopier interface
  651. func (fs *GCSFs) CopyFile(source, target string, _ int64) error {
  652. return fs.copyFileInternal(source, target)
  653. }
  654. func (fs *GCSFs) resolve(name, prefix, contentType string) (string, bool) {
  655. result := strings.TrimPrefix(name, prefix)
  656. isDir := strings.HasSuffix(result, "/")
  657. if isDir {
  658. result = strings.TrimSuffix(result, "/")
  659. }
  660. if contentType == dirMimeType {
  661. isDir = true
  662. }
  663. return result, isDir
  664. }
  665. // getObjectStat returns the stat result
  666. func (fs *GCSFs) getObjectStat(name string) (os.FileInfo, error) {
  667. attrs, err := fs.headObject(name)
  668. if err == nil {
  669. objSize := attrs.Size
  670. objectModTime := attrs.Updated
  671. isDir := attrs.ContentType == dirMimeType || strings.HasSuffix(attrs.Name, "/")
  672. return updateFileInfoModTime(fs.getStorageID(), name, NewFileInfo(name, isDir, objSize, objectModTime, false))
  673. }
  674. if !fs.IsNotExist(err) {
  675. return nil, err
  676. }
  677. // now check if this is a prefix (virtual directory)
  678. hasContents, err := fs.hasContents(name)
  679. if err != nil {
  680. return nil, err
  681. }
  682. if hasContents {
  683. return updateFileInfoModTime(fs.getStorageID(), name, NewFileInfo(name, true, 0, time.Unix(0, 0), false))
  684. }
  685. // finally check if this is an object with a trailing /
  686. attrs, err = fs.headObject(name + "/")
  687. if err != nil {
  688. return nil, err
  689. }
  690. return updateFileInfoModTime(fs.getStorageID(), name, NewFileInfo(name, true, attrs.Size, attrs.Updated, false))
  691. }
  692. func (fs *GCSFs) setWriterAttrs(objectWriter *storage.Writer, flag int, name string) {
  693. var contentType string
  694. if flag == -1 {
  695. contentType = dirMimeType
  696. } else {
  697. contentType = mime.TypeByExtension(path.Ext(name))
  698. }
  699. if contentType != "" {
  700. objectWriter.ObjectAttrs.ContentType = contentType
  701. }
  702. if fs.config.StorageClass != "" {
  703. objectWriter.ObjectAttrs.StorageClass = fs.config.StorageClass
  704. }
  705. if fs.config.ACL != "" {
  706. objectWriter.PredefinedACL = fs.config.ACL
  707. }
  708. }
  709. func (fs *GCSFs) composeObjects(ctx context.Context, dst, partialObject *storage.ObjectHandle) error {
  710. fsLog(fs, logger.LevelDebug, "start object compose for partial file %q, destination %q",
  711. partialObject.ObjectName(), dst.ObjectName())
  712. composer := dst.ComposerFrom(dst, partialObject)
  713. if fs.config.StorageClass != "" {
  714. composer.StorageClass = fs.config.StorageClass
  715. }
  716. if fs.config.ACL != "" {
  717. composer.PredefinedACL = fs.config.ACL
  718. }
  719. contentType := mime.TypeByExtension(path.Ext(dst.ObjectName()))
  720. if contentType != "" {
  721. composer.ContentType = contentType
  722. }
  723. _, err := composer.Run(ctx)
  724. fsLog(fs, logger.LevelDebug, "object compose for %q finished, err: %v", dst.ObjectName(), err)
  725. delCtx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxTimeout))
  726. defer cancelFn()
  727. errDelete := partialObject.Delete(delCtx)
  728. metric.GCSDeleteObjectCompleted(errDelete)
  729. fsLog(fs, logger.LevelDebug, "deleted partial file %q after composing with %q, err: %v",
  730. partialObject.ObjectName(), dst.ObjectName(), errDelete)
  731. return err
  732. }
  733. func (fs *GCSFs) copyFileInternal(source, target string) error {
  734. src := fs.svc.Bucket(fs.config.Bucket).Object(source)
  735. dst := fs.svc.Bucket(fs.config.Bucket).Object(target)
  736. attrs, statErr := fs.headObject(target)
  737. if statErr == nil {
  738. dst = dst.If(storage.Conditions{GenerationMatch: attrs.Generation})
  739. } else if fs.IsNotExist(statErr) {
  740. dst = dst.If(storage.Conditions{DoesNotExist: true})
  741. } else {
  742. fsLog(fs, logger.LevelWarn, "unable to set precondition for rename, target %q, stat err: %v",
  743. target, statErr)
  744. }
  745. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxLongTimeout))
  746. defer cancelFn()
  747. copier := dst.CopierFrom(src)
  748. if fs.config.StorageClass != "" {
  749. copier.StorageClass = fs.config.StorageClass
  750. }
  751. if fs.config.ACL != "" {
  752. copier.PredefinedACL = fs.config.ACL
  753. }
  754. contentType := mime.TypeByExtension(path.Ext(source))
  755. if contentType != "" {
  756. copier.ContentType = contentType
  757. }
  758. _, err := copier.Run(ctx)
  759. metric.GCSCopyObjectCompleted(err)
  760. return err
  761. }
  762. func (fs *GCSFs) renameInternal(source, target string, fi os.FileInfo) (int, int64, error) {
  763. var numFiles int
  764. var filesSize int64
  765. if fi.IsDir() {
  766. if renameMode == 0 {
  767. hasContents, err := fs.hasContents(source)
  768. if err != nil {
  769. return numFiles, filesSize, err
  770. }
  771. if hasContents {
  772. return numFiles, filesSize, fmt.Errorf("cannot rename non empty directory: %q", source)
  773. }
  774. }
  775. if err := fs.mkdirInternal(target); err != nil {
  776. return numFiles, filesSize, err
  777. }
  778. if renameMode == 1 {
  779. entries, err := fs.ReadDir(source)
  780. if err != nil {
  781. return numFiles, filesSize, err
  782. }
  783. for _, info := range entries {
  784. sourceEntry := fs.Join(source, info.Name())
  785. targetEntry := fs.Join(target, info.Name())
  786. files, size, err := fs.renameInternal(sourceEntry, targetEntry, info)
  787. if err != nil {
  788. if fs.IsNotExist(err) {
  789. fsLog(fs, logger.LevelInfo, "skipping rename for %q: %v", sourceEntry, err)
  790. continue
  791. }
  792. return numFiles, filesSize, err
  793. }
  794. numFiles += files
  795. filesSize += size
  796. }
  797. }
  798. } else {
  799. if err := fs.copyFileInternal(source, target); err != nil {
  800. return numFiles, filesSize, err
  801. }
  802. numFiles++
  803. filesSize += fi.Size()
  804. if plugin.Handler.HasMetadater() {
  805. err := plugin.Handler.SetModificationTime(fs.getStorageID(), ensureAbsPath(target),
  806. util.GetTimeAsMsSinceEpoch(fi.ModTime()))
  807. if err != nil {
  808. fsLog(fs, logger.LevelWarn, "unable to preserve modification time after renaming %q -> %q: %+v",
  809. source, target, err)
  810. }
  811. }
  812. }
  813. err := fs.Remove(source, fi.IsDir())
  814. if fs.IsNotExist(err) {
  815. err = nil
  816. }
  817. return numFiles, filesSize, err
  818. }
  819. func (fs *GCSFs) mkdirInternal(name string) error {
  820. if !strings.HasSuffix(name, "/") {
  821. name += "/"
  822. }
  823. _, w, _, err := fs.Create(name, -1, 0)
  824. if err != nil {
  825. return err
  826. }
  827. return w.Close()
  828. }
  829. func (fs *GCSFs) hasContents(name string) (bool, error) {
  830. result := false
  831. prefix := fs.getPrefix(name)
  832. query := &storage.Query{Prefix: prefix}
  833. err := query.SetAttrSelection(gcsDefaultFieldsSelection)
  834. if err != nil {
  835. return result, err
  836. }
  837. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxTimeout))
  838. defer cancelFn()
  839. bkt := fs.svc.Bucket(fs.config.Bucket)
  840. it := bkt.Objects(ctx, query)
  841. // if we have a dir object with a trailing slash it will be returned so we set the size to 2
  842. pager := iterator.NewPager(it, 2, "")
  843. var objects []*storage.ObjectAttrs
  844. _, err = pager.NextPage(&objects)
  845. if err != nil {
  846. metric.GCSListObjectsCompleted(err)
  847. return result, err
  848. }
  849. for _, attrs := range objects {
  850. name, _ := fs.resolve(attrs.Name, prefix, attrs.ContentType)
  851. // a dir object with a trailing slash will result in an empty name
  852. if name == "/" || name == "" {
  853. continue
  854. }
  855. result = true
  856. break
  857. }
  858. metric.GCSListObjectsCompleted(nil)
  859. return result, nil
  860. }
  861. func (fs *GCSFs) getPrefix(name string) string {
  862. prefix := ""
  863. if name != "" && name != "." && name != "/" {
  864. prefix = strings.TrimPrefix(name, "/")
  865. if !strings.HasSuffix(prefix, "/") {
  866. prefix += "/"
  867. }
  868. }
  869. return prefix
  870. }
  871. func (fs *GCSFs) headObject(name string) (*storage.ObjectAttrs, error) {
  872. ctx, cancelFn := context.WithDeadline(context.Background(), time.Now().Add(fs.ctxTimeout))
  873. defer cancelFn()
  874. bkt := fs.svc.Bucket(fs.config.Bucket)
  875. obj := bkt.Object(name)
  876. attrs, err := obj.Attrs(ctx)
  877. metric.GCSHeadObjectCompleted(err)
  878. return attrs, err
  879. }
  880. // GetMimeType returns the content type
  881. func (fs *GCSFs) GetMimeType(name string) (string, error) {
  882. attrs, err := fs.headObject(name)
  883. if err != nil {
  884. return "", err
  885. }
  886. return attrs.ContentType, nil
  887. }
  888. // Close closes the fs
  889. func (fs *GCSFs) Close() error {
  890. return nil
  891. }
  892. // GetAvailableDiskSize returns the available size for the specified path
  893. func (*GCSFs) GetAvailableDiskSize(_ string) (*sftp.StatVFS, error) {
  894. return nil, ErrStorageSizeUnavailable
  895. }
  896. func (*GCSFs) getTempObject(name string) string {
  897. dir := filepath.Dir(name)
  898. guid := xid.New().String()
  899. return filepath.Join(dir, ".sftpgo-partial."+guid+"."+filepath.Base(name))
  900. }
  901. func (fs *GCSFs) getStorageID() string {
  902. return fmt.Sprintf("gs://%v", fs.config.Bucket)
  903. }