Cyberduck Mountain Duck CLI

Changes between Version 81 and Version 82 of help/en/howto/googlestorage


Ignore:
Timestamp:
Apr 16, 2021 10:58:58 AM (6 months ago)
Author:
svogt
Comment:

Updated links and references

Legend:

Unmodified
Added
Removed
Modified
  • help/en/howto/googlestorage

    v81 v82  
    33= [wiki:help/en Cyberduck Help] / [wiki:help/en/howto Howto] / Google Cloud Storage =
    44
    5 [http://code.google.com/apis/storage/ Google Cloud Storage] is a S3 compatible service with pricing based on usage. Google Cloud Storage is interoperable with  [wiki:help/en/howto/s3 S3].
     5[https://cloud.google.com/storage/docs Google Cloud Storage] is an S3 compatible service with pricing based on usage. Google Cloud Storage is interoperable with  [wiki:help/en/howto/s3 S3].
    66
    77== Connecting to Google Cloud Storage ==
    88
    99== Interoperable Access ==
    10 For interoperable access please use a S3-compatible protocol (like Amazon S3, not Google Storage) with server set to `storage.googleapis.com`.
     10For interoperable access please use an S3-compatible protocol (like Amazon S3, not Google Storage) with the server set to `storage.googleapis.com`.
    1111
    1212You need to obtain the login credentials (''Access Key'' and ''Secret'') from the [https://console.cloud.google.com Google Cloud Platform] settings for "Storage". Please navigate to the [https://console.cloud.google.com/storage/settings storage settings]. Open the "Interoperability"-tab and enable "Interoperable Access". After enabling you may now create a new key. For more information refer to the [https://cloud.google.com/storage/docs/migrating Google Storage Documentation].
     
    1515
    1616== OAuth 2.0 Access ==
    17 You must obtain the project ID (`x-goog-project-id`) of your project from the [https://console.cloud.google.com/storage/settings Google Cloud Platform] under ''Storage Access'' from the Google Cloud Storage tab. [https://console.cloud.google.com/storage/settings Direct link to Google Cloud Storage settings]
     17You must obtain the project ID (`x-goog-project-id`) of your project from the Google Cloud Platform under ''Storage Access'' from the Google Cloud Storage tab. [https://console.cloud.google.com/storage/settings Direct link to Google Cloud Storage settings.]
    1818
    1919[[Image(Project ID Bookmark Configuration.png, 400px)]]
    2020
    21 In the login prompt of Cyberduck you enter the `x-goog-project-id` for the username and enter the ''Authorization Code'' retrieved from the website where you grant Cyberduck acccess to your account.
     21In the login prompt of Cyberduck, you enter the `x-goog-project-id` for the username and enter the ''Authorization Code'' retrieved from the website where you grant Cyberduck access to your account.
    2222
    2323[[Image(OAuth Token.png)]]
    2424
    25 You access the page with the authorization code from the link displayed in the login prompt. Click it to open it in a web browser window. You only need to get the authorization code from the website on the first login attempt. Subsequent OAuth authentications will use a refresh token retrieved from service.
     25You access the page with the authorization code from the link displayed in the login prompt. Click it to open it in a web browser window. You only need to get the authorization code from the website on the first login attempt. Subsequent OAuth authentications will use a refresh token retrieved from the service.
    2626
    2727'''OAuth Reset'''
     
    4242
    4343== Creating a bucket ==
    44 When connecting the first time, you must first create a new bucket with ''File → New Folder... (⌘-N)''. You can choose the bucket location in ''Preferences (⌘-,) → S3'' The following locations are supported:
     44When connecting the first time, you must first create a new bucket with ''File → New Folder... (macOS `⌘N` Windows `Ctrl+Shift+N`)''. You can choose the bucket location in ''Preferences (macOS `⌘,` Windows `Ctrl+,`) → S3'' The following locations are supported:
    4545 * US
    4646 * EU - Europe
    4747
    4848== Bucket Access Logging ==
    49 When this option is enabled in the ''Google Cloud Storage'' panel of the Info (''File →  Info (⌘-I)'') window for a bucket or any file within, available log records for this bucket are periodically aggregated into log files and delivered to root in the target logging bucket specified. It is considered best practice to [http://blog.qloudstat.com/2012/04/24/choose-a-logging-target/ choose a logging target] that is different from the origin bucket.
     49When this option is enabled in the ''Google Cloud Storage'' panel of the Info (''File →  Info (macOS `⌘I` Windows `Alt+Enter`)'') window for a bucket or any file within, available log records for this bucket are periodically aggregated into log files and delivered to root in the target logging bucket specified. It is considered best practice to choose a logging target that is different from the origin bucket.
    5050
    5151[[Image(Google Storage Access Log Configuration.png)]]
    5252
    5353== Folders ==
    54 Creating a folder inside a bucket will create a placeholder object named after the directory, has no data content and the mimetype `application/x-directory`. Directory placeholder objects created in ''Google Storage Manager'' are [https://groups.google.com/group/gs-discussion/browse_thread/thread/fb90359bd714c717/44094e60372427d4#44094e60372427d4 not supported].
     54Creating a folder inside a bucket will create a placeholder object named after the directory, has no data content, and the mime-type `application/x-directory`. Directory placeholder objects created in ''Google Storage Manager'' are [https://groups.google.com/group/gs-discussion/browse_thread/thread/fb90359bd714c717/44094e60372427d4#44094e60372427d4 not supported].
    5555
    5656== Files ==
    5757=== Metadata ===
    58 You can edit standard HTTP headers [wiki:help/en/howto/info#MetadataHTTPheaders add] custom HTTP headers to files to store [http://docs.amazonwebservices.com/AmazonS3/latest/index.html?UsingMetadata.html metadata]. Choose ''File → Info → Google Storage'' to edit headers.
     58You can edit standard HTTP headers [wiki:help/en/howto/info#MetadataHTTPheaders add] custom HTTP headers to files to store [https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html metadata]. Choose ''File → Info → Google Storage'' to edit headers.
    5959
    6060== ACLs ==
    6161=== Default ACLs ===
    62  * '''Buckets'''. New buckets created have a default pre-defined canned ACL set to `public-read`. You get `FULL_CONTROL`. All other users have `READ` access.
     62 * '''Buckets''' New buckets created have a default pre-defined canned ACL set to `public-read`. You get `FULL_CONTROL`. All other users have `READ` access.
    6363
    6464=== Granting access to selected users ===
     
    8686
    8787== Website Configuration ==
    88 To host a static website on Google Cloud Storage, It is possible to define a bucket as a ''Website Endpoint''. The configuration in ''File → Info (⌘-I) → Distribution'' allows you to enable website configuration. Choose ''Website Configuration (HTTP)'' from ''Delivery Method'' and define an index document name that is searched for and returned when requests are made to the root or the subfolder in your bucket.
     88To host a static website on Google Cloud Storage, It is possible to define a bucket as a ''Website Endpoint''. The configuration in ''File → Info (macOS `⌘I` Windows `Alt+Enter`) → Distribution'' allows you to enable website configuration. Choose ''Website Configuration (HTTP)'' from ''Delivery Method'' and define an index document name that is searched for and returned when requests are made to the root or the subfolder in your bucket.
    8989
    9090Website Configuration parameters will only affect requests directed to CNAME aliases of a bucket.
    9191
    9292=== Index File ===
    93 Simulates directory index behavior at both bucket and "directory" level. The file specified is served for requests to the website endpoint as the main page for the bucket and for requests to "directories" contained by the bucket.
     93Simulates directory index behavior at both bucket and "directory" levels. The file specified is served for requests to the website endpoint as the main page for the bucket and for requests to "directories" contained by the bucket.
    9494
    9595== Limitations ==
     
    100100== References ==
    101101
    102  * [http://code.google.com/apis/storage/docs/faq.html Google Cloud Storage Frequently Asked Questions]
     102 * [https://cloud.google.com/storage/docs/faq Google Cloud Storage Frequently Asked Questions]