How do I configure an S3 drive? about cbfs

[elpete]

Looks like the docs need to be updated with the S3Provider. Here is the init method for the S3Provider:

	/**
	 * Configure the provider. Usually called at startup.
	 *
	 * @properties A struct of configuration data for this provider, usually coming from the configuration file
	 *
	 * @return S3Provider
	 */
	public IDisk function configure( required string name, struct properties = {} ){
		try {
			variables.s3 = variables.wirebox.getInstance( "AmazonS3@s3sdk" );
		} catch ( any e ) {
			throw(
				type    = "cbfs.ProviderConfigurationException",
				message = "The the S3Provider encountered a fatal error during configuration. The message received was #e.message#."
			);
		}

		if ( !arguments.properties.keyExists( "bucketName" ) ) {
			arguments.properties.bucketName = variables.s3.getDefaultBucketName();
		}

		if ( !arguments.properties.keyExists( "visibility" ) ) {
			arguments.properties.visiblity = "public";
		}

		setName( arguments.name );
		setProperties( arguments.properties );
		return this;
	}

So you need s3sdk installed, and you can optionally pass bucketName and visibility.

What I don't see is any way to configure the underlying S3 instance from cbfs. My guess is you would configure the s3sdk directly. That doesn't allow for interacting with multiple S3 instances, though....

[jclausen]

The documentation for S3 configuration is available here: https://cbfs.ortusbooks.com/getting-started/providers/s3-provider