Skip to main content
Connect object storage to a cluster of 1C servers
Last update:

Connect object storage to a cluster of 1C servers

Object Storage is a service for storing and distributing unlimited amounts of data.You can connect Object Storage to your 1C server cluster to save media files — images and documents — there.This will allow you to:

  • reduce the number of requests to the database cluster — requests for file actions will be addressed to the storage container;
  • increase the reliability of media file storage — data in object storage is replicated to three independent servers in different racks;
  • Edit and replace media files in the container in the control panel or using the storage tools.

Principle of operation

You connect the storage to the 1C server cluster in the control panel, then configure the media storage method in the 1C configuration menu.

New media files will then start to be sent to the storage.Existing media files will not be automatically moved to the storage, you can move them after you connect.

Once connected and configured, you will be able to work with media files both through 1C and storage — files will be created, modified and deleted in storage, their current state will be displayed in 1C.

The object storage has a flat address structure — there are no folders and hierarchy in the storage, but you can create and view simulated folders (directories) for convenience. The folder name is a prefix in the object name.

You cannot connect parent and child directories in the same container at the same time. For example, if the example/images directory is connected, you cannot connect its parent directory example or child directory example/images/photos, but you can connect the example/documents directory.

Two ways to connect object storage are available:

  • automatically — you can connect an existing container or create a new one. The service user and access policies for working with the container will be created automatically;
  • manually — you can connect an existing container. You must create the service user and access policies yourself.

Restrictions and recommendations for containers

Only containers can be connected to the 1C server cluster:

For optimal performance, we recommend choosing containers:

  • with a private type;
  • in the region and pool where the 1C server cluster is located.

Cost

File storage in a container is charged using the payment model and object storage pricing.

When deleting a cluster of 1C servers, files from connected containers are not deleted and continue to be charged — to stop charging , delete the containers.

Connect the container to the cluster automatically

When connected, the default container will be created and configured:

  • GO1C_SERVICE_USER service user;
  • access policy for service user GO1C_POLICY;
  • access policy for the current control panel user ALL_OTHER.

The container can be automatically connected by a user with the Account Owner role and users with role combinations:

  • Account Administrator and User Administrator;
  • Project Administrator and User Administrator.

You can connect the container only to a cluster of 1C servers in ACTIVE status.

:::dangerWhen changing, deleting a service user or access policies, the connection to the 1C server cluster may be severed, but the connection status in the control panel will not change.::::

  1. In the control panel, in the top menu, click Products1C Ready Cloud1C Server Clusters section.

  2. Open the cluster page → Storage tab.

  3. Click Connect.

  4. Select the connection type — Automatic.

  5. In the Region and Pool fields, select the region and pool in which the container will be created. We recommend creating the container in the same region and pool as the 1C server cluster.

  6. In the Container field, select New Object Storage Container. A private container with Virtual-Hosted addressing and a standard storage class will be created.

  7. In the Container name field, specify the name of the new container. For compatibility with the S3 API, the container name must be unique within the object store and conform to Amazon S3 bucket naming rules, see the Bucket naming rules instructions in the Amazon documentation.

  8. In the Prefix field, specify a prefix for the simulated folder (directory) where the media files will be stored.

    To create a new folder, name the folder according to the Amazon S3 buckets naming rules. The folder will be created automatically.

    If the media files will be stored in the root of the container, leave the field blank.

  9. Click Create Connection.

Connect the container to the cluster manually

You can connect the container only to a cluster of 1C servers in ACTIVE status.

:::dangerWhen changing, deleting a service user or access policies, the connection to the 1C server cluster may be severed, but the connection status in the control panel will not change.::::

  1. Prepare the container for connection.
  2. Connect the container.

1. Prepare the container for connection

  1. Make sure you are in a project that hosts a cluster of 1C servers.

  2. Create a service user with the Object Storage User role and access to the project where the container will be created.

  3. Create a container in the object store. Take into account restrictions and guidelines for containers.

  4. Go to Object StorageContainers.

  5. Open the page of the created container → Access Policy tab.

  6. Click Create Access Policy.

  7. Add a rule for the service account:

    • in the Access field, select Allow;
    • in the Users field, select Authorized and add the service user you created in step 2;
    • in the Action Set field, select Editor.
  8. Add a rule for control panel users:

    • in the Access field, select Allow;
    • in the Users field select Authorized and add a control panel user who will connect the storage to the 1C cluster;
    • in the Action Set field, select All.
  9. Click Save.

  10. Issue S3 keys for the service user.

2. Connect the container

  1. In the control panel, in the top menu, click Products1C Ready Cloud1C Server Clusters section.

  2. Open the cluster page → Storage tab.

  3. Click Connect.

  4. Select the connection type — Manual.

  5. In the Region and Pool fields, select the region and pool where the container is located.

  6. In the Container field, select the container you prepared earlier.

  7. In the Prefix field, specify a prefix for the simulated folder (directory) where the media files will be stored.

    To create a new folder, name the folder according to the Amazon S3 buckets naming rules. The folder will be created automatically.

    If the media files will be stored in the root of the container, leave the field blank.

  8. In the S3 keys block, specify the Access key and Secret key for the service user that you created when preparing the container.

  9. Click Create Connection.

Disconnect the container

You can disconnect a container only from a cluster of 1C servers in the ACTIVE status.When disconnecting a container from the cluster, the S3 key of the service user and the access policy rule for the service user that were created for this container will be deleted.

  1. In the control panel, in the top menu, click Products1C Ready Cloud1C Server Clusters section.
  2. Open the cluster page → Storage tab.
  3. In the line with the container, click .
  4. Enter the name of the container to confirm the deletion.
  5. Click Disconnect. If you no longer need the container, delete it.