Skip to content

Latest commit

 

History

History
1386 lines (981 loc) · 54.4 KB

CHANGELOG.rst

File metadata and controls

1386 lines (981 loc) · 54.4 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased]

[2.7.2] - 2021-10-08

Added

  • 'Make all instances writeable' configuration field can be hidden via frontend-core's set_variable feature or at runtime.

  • New get_issues callback in role API to collect user-defined issues. The issues are gathered from the enabled roles only (present in service-registry).

  • Allow disabling built-in HTTP "admin" user:

    • by specifying auth_builtin_admin_enabled: false in the instances.yml;

    • using TARANTOOL_AUTH_BUILTIN_ADMIN_ENABLED=false environment variable;

    • permanently in init.lua:

      -- init.lua
      
      require('cartridge.auth-backend').set_builtin_admin_enabled(false)
      cartridge.cfg({
          auth_backend_name = 'cartridge.auth-backend',
          ...
      })

Changed

  • Make built-in HTTP "admin" user a part of default auth backend. Custom backends are free of it now.

Fixed

  • Eliminate unnecessary transactions after the restart before the replication sync. This reduces the chance the hardware restart leads to WAL corruption (#1546).
  • Fix net.box clients compatibility with future tarantool 2.10 versions.
  • Fix vshard rebalancer broken by roles reload.

[2.7.1] - 2021-08-18

Fixed

  • Compatibility with Tarantool 2.9 (update errors dependency to 2.2.1).

[2.7.0] - 2021-08-10

Added

  • New suggestion to restart replication. Whenever the replication isn't running and the reason isn't in the dead upstream, Cartridge will show the corresponding banner in WebUI.

  • More server details in WebUI: membership, vshard-router, and vshard-storage.

  • Roles are stopped with the on_shutdown trigger where it's supported (in Tarantool 2.8+).

  • New cartridge.cfg options:

    • webui_prefix (default: "") allows to modify WebUI routes.
    • webui_enforce_root_redirect (default: true) manage redirection.

    To sum up, now they look as follows:

    • <PREFIX>/admin/;
    • <PREFIX>/admin/api;
    • <PREFIX>/admin/config;
    • <PREFIX>/admin/cluster/*;
    • <PREFIX>/static/*;
    • <PREFIX>/login;
    • <PREFIX>/logout;
    • / and <PREFIX>/ redirect to /<PREFIX>/admin (if enabled).
  • New validate_config method in GraphQL API.

  • Add zone and zone_distances parameters to test helpers.

  • Support rebalancer_max_sending vshard option.

Changed

  • Merge "Schema" and "Code" pages. Also, allow validating all files, not only the schema.yml.
  • Allow expelling a leader. Cartridge will appoint a new leader according to the failover priority from the topology.
  • Add default pool.map_call timeout 10 seconds.
  • Forbid starting an instance absent in instances.yml.
  • Update errors dependency to 2.2.0 with a new method errors.netbox_wait_async to wait for netbox.future result.
  • Update membership dependency to 2.4.0 (Changelog).
  • Update ddl dependency to 1.5.0 which supplements the clusterwide config with an example schema (Changelog).
  • Update vshard to 0.1.18 (Changelog).

Fixed

  • Leaders replaced during stateful failover can be expelled now.
  • Make failover logging more verbose.
  • Fix hot-reload for roles that leave gaps in httpd routes.
  • Check user e-mail uniqueness when editing.
  • Expelled instances are removed from the _cluster space.
  • Fix get_enabled_roles to work without arguments.
  • Don't default to syslog driver unless /dev/log or /var/run/syslog are available.
  • Fix inappropriate consistency timeout that led to "Timed out" error during forceful leader promotion.
  • Support automatic parsing of Tarantool Enterprise box options audit_log and audit_nonblock.
  • Instance won't suspect any members during RecoveringSnapshot and BootstrappingBox.

Enhanced in WebUI

  • Allow to blacklist subpages for complex modules.
  • Fix notifications displaying. Close it by clicking anywhere. Keep it open while the mouse is over.
  • Various styles enhancements.

[2.6.0] - 2021-04-26

Added

  • Update vshard to 0.1.17. (Changelog).
  • Update graphql to 0.1.1. (Changelog).
  • New test helper: cartridge.test-helpers.stateboard.
  • New failover option in the cluster test helper for easier failover setup.

Changed

  • Move DDL related code out of Cartridge and ship it as a permaent role in the ddl rock. No observable functionality is affected. The roles remains registered implicitly. Nonetheless it's recomended to add it explicitly to cartridge.cfg({roles = {'cartridge.roles.ddl-manager'}}) (if it's actually used) as this implicity may be removed in future.

Fixed

  • Fix unclear timeout errors in case of InitError and BootError states.
  • Fix inconsistency which could occur while longpolling stateboard in unstable networks.
  • Increase timeout for the validate_config stage from 1 to 10 seconds. It afftected config_patch_clusterwide in v2.5, mostly on large clusters.

Enhanced in WebUI

  • Highlight if file name exists in file create/rename mode on Code page.

[2.5.1] - 2021-03-24

Added

  • Extend GraphQL issues API with aliens topic. The issues warns if two separate clusters share the same cluster cookie.
  • Enhance error messages when they're transferred over network. Supply it with the connection URI.

Fixed

  • Don't skip two-phase commit prematurely. From now on, the decision to skip the apply_config is made by every instance individually. The validation step is never skipped.
  • Avoid WebUI and pool.map_call requests hanging because of network connection problems.
  • Fix unclear "Timeout exceeded" error. It affects v2.5.0 two-phase commit when an instance is stuck in ConfiguringRoles state.
  • Make the "Replication isn't running" issue critical instead of a warning.

[2.5.0] - 2021-03-05

Added

Issues and suggestions:

  • Show an issue when ConfiguringRoles state gets stuck for more than 5s.
  • New GraphQL API: { cluster { suggestions { force_apply } } } to heal the cluster in case of config errors like Configuration checksum mismatch, Configuration is prepared and locked, and sometimes OperationError.
  • New GraphQL API: { cluster { suggestions { disable_servers } } } to restore the quorum in case of some servers go offline.

Configuration options:

  • New cartridge.cfg option webui_enabled (default: true). Otherwise, HTTP server remains operable (and GraphQL too), but serves user-defined roles API only.
  • New cartridge.cfg option http_host (default: 0.0.0.0) which allows to specify the bind address of the HTTP server.

Miscellaneous:

  • Allow observing cluster from an unconfigured instance WebUI.
  • Introduce a new graphql parser (libgraphqlparser instead of lulpeg). It conforms to the newer GraphQL specification and provides better error messages. The "null" literal is now supported. But some other GraphQL expressions are considered invalid (e.g. empty subselection).

Fixed

  • Properly handle etcd index updates while polling stateful failover updates. The problem affected long-running clusters and resulted in flooding logs with the "Etcd cluster id mismatch" warnings.
  • Refactor two-phase commit (patch_clusterwide) logics: don't use hardcoded timeout for the prepare stage, move upload to a separate stage.
  • Eliminate GraphQL error "No value provided for non-null ReplicaStatus" when a replica is removed from the box.space._cluster.
  • Allow specifying server zone in join_server API.
  • Don't make formatting ugly during config upload.

Enhanced is WebUI

  • Allow disabling instances and fix their style.
  • Show a suggestion to disable broken instances.
  • Show a suggestion to force reapply clusterwide configuration.
  • Hide the bootstrap button when it's not necessary (e.g. before the cluster is bootstrapped, and in vshardless cluster too).
  • Properly display an error if changing server zone fails.

[2.4.0] - 2020-12-29

Added

Zones and zone distances:

  • Add support of replica weights and zones via a clusterwide config new section zone_distances and a server parameter zone.

Fencing:

  • Implement a fencing feature. It protects a replicaset from the presence of multiple leaders when the network is partitioned and forces the leader to become read-only.
  • New failover parameter failover_timout specifies the time (in seconds) used by membership to mark suspect members as dead which triggers failover.
  • Fencing parameters fencing_enabled, fencing_pause, fencing_timeout are available for customization via Lua and GraphQL API, and in WebUI too.

Issues and suggestions:

  • New GraphQL API: { cluster { suggestions { refine_uri } } } to heal the cluster after relocation of servers advertise_uri.

  • New Lua API cartridge.config_force_reapply() and similar GraphQL mutation cluster { config_force_reapply() } to heal several operational errors:

    • "Prepare2pcError: Two-phase commit is locked";
    • "SaveConfigError: .../config.prepare: Directory not empty";
    • "Configuration is prepared and locked on ..." (an issue);
    • "Configuration checksum mismatch on ..." (an issue).

    It'll unlock two-phase commit (remove config.prepare lock), upload the active config from the current instance and reconfigure all roles.

Hot-reload:

  • New feature for hot reloading roles code without restarting an instance -- cartridge.reload_roles. The feature is experimental and should be enabled explicitly: cartridge.cfg({roles_reload_allowed = true}).

Miscellaneous:

  • New cartridge.cfg option swim_broadcast to manage instances auto-discovery on start. Default: true.
  • New argparse options support for tarantool 2.5+: replication_synchro_quorum, replication_synchro_timeout, memtx_use_mvcc_engine.

Changed

  • Default value of failover_timeout increased from 3 to 20 seconds (important change).
  • RPC functions now consider suspect members as healthy to be in agreement with failover (important change).

Fixed

  • Don't stuck in ConnectingFullmesh state when instance is restarted with a different advertise_uri. Also keep "Server details" dialog in WebUI operable in this case.
  • Allow applying config when instance is in OperationError. It doesn't cause loss of quorum anymore.
  • Stop vshard fibers when the corresponding role is disabled.
  • Make console.listen error more clear when console_sock exceeds UNIX_PATH_MAX limit.
  • Fix upstream.idle issue tolerance to avoid unnecessary warnings "Replication: long idle (1 > 1)".
  • Allow removing spaces from DDL schema for the sake of drop migrations.
  • Make DDL schema validation stricter. Forbid redundant keys in schema top-level and make spaces mandatory.

Enhanced is WebUI

  • Update server details modal, add support for server zones.
  • Properly display errors on WebUI pages "Users" and "Code".
  • Indicate config checksum mismatch in issues list.
  • Indicate the change of arvertise_uri in issues list.
  • Show an issue if the clusterwide config is locked on an instance.
  • Refresh interval and stat refresh period variables can be customized via frontend-core's set_variable feature or at runtime.

[2.3.0] - 2020-08-26

Added

  • When failover mode is stateful, all manual leader promotions will be consistent: every instance before becoming writable performs wait_lsn operation to sync with previous one. If consistency couldn't be reached due to replication failure, a user could either revert it (promote previous leader), or force promotion to be inconsistent.
  • Early logger initialization (for Tarantool > 2.5.0-100, which supports it).
  • Add probe_uri_timeout argparse option responsible for retrying "Can't ping myself" error on startup.
  • New test helper: cartridge.test-helpers.etcd.
  • Support on_push and on_push_ctx options for cartridge.rpc_call().
  • Changing users password invalidates HTTP cookie.
  • Support GraphQL default variables.

Fixed

  • Eventual failover may miss an event while roles are being reconfigured.
  • Compatibility with pipe logging, see tarantool/tarantool#5220.
  • Non-informative assertion when instance is bootstrapped with a distinct advertise_uri.
  • Indexing nil value in get_topology() query.
  • Initialization race of vshard storage which results in OperationError.
  • Lack of vshard router attempts to reconnect to the replicas.
  • Make GraphQL syntax errors more clear.
  • Better errors.pcall() performance, errors rock updated to v2.1.4.

Enhanced is WebUI

  • Show instance names in issues list.
  • Show app name in window title.
  • Add the "Force leader promotion" button in the stateful failover mode.
  • Indicate consistent switchover problems with a yellow leader flag.

[2.2.0] - 2020-06-23

Added

  • When running under systemd use <APP_NAME>.<INSTANCE_NAME> as default syslog identity.
  • Support etcd as state provider for stateful failover.

Changed

  • Improve rocks detection for feedback daemon. Besides cartridge version it now parses manifest file from the .rocks/ directory and collects rocks versions.
  • Make uuid parameters optional for test helpers. Make servers option accept number of servers in replicaset.

Enhanced in WebUI

  • Prettier errors displaying.
  • Enhance replicaset filtering by role / status.
  • Error stacktrace received from the backend is shown in notifications.

[2.1.2] - 2020-04-24

Fixed

  • Avoid trimming console_sock if it's name is too long.
  • Fix file descriptors leak during box recovery.
  • Support console_sock option in stateboard as well as notify socket and other box options similar to regular cartridge instances.

[2.1.1] - 2020-04-20

Fixed

  • Frontend core update: fix route mapping

[2.1.0] - 2020-04-16

Added

  • Implement stateful failover mode. You can read more in ":ref:`Failover architecture <cartridge-failover>`" documentation topic.
  • Respect box.cfg options wal_dir, memtx_dir, vinyl_dir. They can be either absolute or relative - in the later case it's calculated relative to cartridge.workdir.
  • New option in cartridge.cfg({upgrade_schema=...}) to automatically upgrade schema to modern tarantool version (only for leader). It also has been added for argparse.
  • Extend GraphQL issues API with various topics: replication, failover, memory, clock. Make thresholds configurable via argparse.

Changed

  • Make GraphQL validation stricter: scalar values can't have sub-selections; composite types must have sub-selections; omitting non-nullable arguments in variable list is forbidden. Your code may be affected if it doesn't conform GraphQL specification.
  • GraphQL query auth_params returns "fullname" (if it was specified) instead of "username".
  • Update errors dependency to 2.1.3.
  • Update ddl dependency to 1.1.0.

Deprecated

Lua API:

  • cartridge.admin_get_failover -> cartridge.failover_get_params
  • cartridge.admin_enable/disable_failover -> cartridge.failover_set_params

GraphQL API:

  • query {cluster {failover} } -> query {cluster {failover_params {...} } }
  • mutation {cluster {failover()} } -> mutation {cluster {failover_params() {...} } }

Fixed

  • Properly handle nested input object in GraphQL:

    mutation($uuid: String!) {
      cluster { edit_topology(servers: [{uuid: $uuid ...}]) {} }
    }
    
  • Show WebUI notification on successful config upload.

  • Repair GraphQL queries add_user, issues on uninitialized instance.

Enhanced in WebUI

  • Show "You are here" marker.
  • Show application and instance names in app title.
  • Indicate replication and failover issues.
  • Fix bug with multiple menu items selected.
  • Refactor pages filtering, forbid opening blacklisted pages.
  • Enable JS chunks caching.

[2.0.2] - 2020-03-17

Added

  • Expose membership options in argparse module (edit them with environment variables and command-line arguments).
  • New internal module to handle .tar files.

Lua API:

  • cartridge.cfg({webui_blacklist = {'/admin/code', ...}}): blacklist certain WebUI pages.
  • cartridge.get_schema() referencing older _G.cartridge_get_schema.
  • cartridge.set_schema() referencing older _G.cartridge_set_schema.

GraphQL API:

  • Make use of GraphQL error extensions: provide additional information about class_name and stack of original error.
  • cluster{ issues{ level message ... }}: obtain more details on replication status
  • cluster{ self {...} }: new fields app_name, instance_name.
  • servers{ boxinfo { cartridge {...} }}: new fields version, state, error.

Test helpers:

  • Allow specifying all_rw replicaset flag in luatest helpers.
  • Add cluster({env = ...}) option for specifying clusterwide environment variables.

Changed

  • Remove redundant topology availability checks from two-phase commit.
  • Prevent instance state transition from ConnectingFullmesh to OperationError if replication fails to connect or to sync. Since now such fails result in staying in ConnectingFullmesh state until it succeeds.
  • Specifying pool.connect() options user, password, reconnect_after are deprecated and ignored, they never worked as intended and will never do. Option connect_timeout is deprecated, but for backward compatibility treated as wait_connected.

Fixed

  • Fix DDL failure if spaces field is null in input schema.
  • Check content of cluster_cookie for absence of special characters so it doesn't break the authorization. Allowed symbols are [a-zA-Z0-9_.~-].
  • Drop remote-control connections after full-featured box.cfg becomes available to prevent clients from using limited functionality for too long. During instance recovery remote-control won't accept any connections: clients wait for box.cfg to finish recovery.
  • Update errors rock dependency to 2.1.2: eliminate duplicate stack trace from error.str field.
  • Apply custom_proc_title setting without waiting for box.cfg.
  • Make GraphQL compatible with req:read_cached() call in httpd hooks.
  • Avoid "attempt to index nil value" error when using rpc on an uninitialized instance.

Enhanced in WebUI

  • Add an ability to hide certain WebUI pages.
  • Validate YAML in code editor WebUI.
  • Fix showing errors in Code editor page.
  • Remember last open file in Code editor page. Open first file when local storage is empty.
  • Expand file tree in Code editor page by default.
  • Show Cartridge version in server info dialog.
  • Server alias is clickable in replicaset list.
  • Show networking errors in splash panel instead of notifications.
  • Accept float values for vshard-storage weight.

[2.0.1] - 2020-01-15

Added

  • Expose TARANTOOL_DEMO_URI environment variable in GraphQL query cluster{ self{demo_uri} } for demo purposes.

Fixed

  • Notifications in schema editor WebUI.
  • Fix GraphQL servers query compatibility with old cartridge versions.
  • Two-phase commit backward compatibility with v1.2.0.

[2.0.0] - 2019-12-27

Added

  • Use for frontend part single point of configuration HTTP handlers. As example: you can add your own client HTTP middleware for auth.
  • Built-in DDL schema management. Schema is a part of clusterwide configuration. It's applied to every instance in cluster.
  • DDL schema editor and code editor pages in WebUI.
  • Instances now have internal state machine which helps to manage cluster operation and protect from invalid state transitions.
  • WebUI checkbox to specify all_rw replicaset property.
  • GraphQL API for clusterwide configuration management.
  • Measure clock difference across instances and provide clock_delta in GraphQL servers query and in admin.get_servers() Lua API.
  • New option in rpc_call(..., {uri=...}) to perform a call on a particular uri.

Changed

  • cartridge.rpc_get_candidates() doesn't return error "No remotes with role available" anymore, empty table is returned instead. (incompatible change)
  • Base advertise port in luatest helpers changed from 33000 to 13300, which is outside ip_local_port_range. Using port from local range usually caused tests failing with an error "address already in use". (incompatible change, but affects tests only)
  • Whole new way to bootstrap instances. Instead of polling membership for getting clusterwide config the instance now start Remote Control Server (with limited iproto protocol functionality) on the same port. Two-phase commit is then executed over net.box connection. (major change, but still compatible)
  • Failover isn't triggered on suspect instance state anymore
  • Functions admin.get_servers, get_replicasets and similar GraphQL queries now return an error if the instance handling the request is in state InitError or BootError.
  • Clusterwide configuration is now represented with a file tree. All sections that were tables are saved to separate .yml files. Compatibility with the old-style configuration is preserved. Accessing unmarshalled sections with get_readonly/deepcopy methods is provided without .yml extension as earlier. (major change, but still compatible)
  • After an old leader restarts it'll try to sync with an active one before taking the leadership again so that failover doesn't switch too early before leader finishes recovery. If replication setup fails the instance enters the OperationError state, which can be avoided by explicitly specifying replication_connect_quorum = 1 (or 0). (major change)
  • Option {prefer_local = false} in rpc_call makes it always use netbox connection, even to connect self. It never tries to perform call locally.
  • Update vshard dependency to 0.1.14.

Removed

  • Function cartridge.bootstrap is removed. Use admin_edit_topology interad. (incompatible change)
  • Misspelled role callback validate is now removed completely. Keep using validate_config.

Fixed

  • Arrange proper failover triggering: don't miss events, don't trigger if nothing changed. Fix races in calling apply_config between failover and two-phase commit.
  • Race condition when creating working directory.
  • Hide users page in WebUI when auth backend implements no user management functions. Enable auth switcher is displayed on main cluster page in this case.
  • Displaying boolean values in server details.
  • Add deduplication for WebUI notifications: no more spam.
  • Automatically choose default vshard group in create and edit replicaset modals.
  • Enhance WebUI modals scrolling.

[1.2.0] - 2019-10-21

Added

  • 'Auto' placeholder to weight input in the Replicaset forms.
  • 'Select all' and 'Deselect all' buttons to roles field in Replicaset add and edit forms.
  • Refresh replicaset list in UI after topology edit actions: bootstrap, join, expel, probe, replicaset edit.
  • New Lua API cartridge.http_authorize_request() suitable for checking HTTP request headers.
  • New Lua API cartridge.http_render_response() for generating HTTP response with proper Set-Cookie headers.
  • New Lua API cartridge.http_get_username() to check authorization of active HTTP session.
  • New Lua API cartridge.rpc_get_candidates() to get list of instances suitable for performing a remote call.
  • Network error notification in UI.
  • Allow specifying vshard storage group in test helpers.

Changed

  • Get UI components from Tarantool UI-Kit
  • When recovering from snapshot, instances are started read-only. It is still possible to override it by argparse (command line arguments or environment variables)

Fixed

  • Editing topology with failover_priority argument.
  • Now cartridge.rpc.get_candidates() returns value as specified in doc. Also it accepts new option healthy_only to filter instances which have membership status healthy.
  • Replicaset weight tooltip in replicasets list
  • Total buckets count in buckets tooltip
  • Validation error in user edit form
  • Leader flag in server details modal
  • Human-readable error for invalid GrqphQL queries: Field "x" is not defined on type "String"
  • User management error "attempt to index nil value" when one of users has empty e-mail value
  • Catch rpc_call errors when they are performed locally

[1.1.0] - 2019-09-24

Added

  • New Lua API admin_edit_topology has been added to unite multiple others: admin_edit_replicaset, admin_edit_server, admin_join_server, admin_expel_server. It's suitable for editing multiple servers/replicasets at once. It can be used for bootstrapping cluster from scratch, joining a server to an existing replicaset, creating new replicaset with one or more servers, editing uri/labels of servers, disabling or expelling servers.
  • Similar API is implemented in a GraphQL mutation cluster{edit_topology()}.
  • New GraphQL mutation cluster { edit_vshard_options } is suitable for fine-tuning vshard options: rebalancer_max_receiving, collect_lua_garbage, sync_timeout, collect_bucket_garbage_interval, rebalancer_disbalance_threshold.

Changed

  • Both bootstrapping from scratch and patching topology in clusterwide config automatically probe servers, which aren't added to membership yet (earlier it influenced join_server mutation only). This is a prerequisite for multijoin api implementation.
  • WebUI users page is hidden if auth_backend doesn't provide list_users callback.

Deprecated

Lua API:

  • cartridge.admin_edit_replicaset()
  • cartridge.admin_edit_server()
  • cartridge.admin_join_server()
  • cartridge.admin_expel_server()

GraphQL API:

  • mutation{ edit_replicaset() }
  • mutation{ edit_server() }
  • mutation{ join_server() }
  • mutation{ expel_server() }

Fixed

  • Protect users_acl and auth sections when downloading clusterwide config. Also forbid uploading them.

[1.0.0] - 2019-08-29

Added

  • New parameter topology.replicasets[].all_rw in clusterwide config for configuring all instances in the replicaset as read_only = false. It can be managed with both GraphQL and Lua API edit_replicaset.
  • Remote Control server - a replacement for the box.cfg({listen}), with limited functionality, independent on box.cfg. The server is only to be used internally for bootstrapping new instances.
  • New module argparse for gathering configuration options from command-line arguments, environment variables, and configuration files. It is used internally and overrides cluster.cfg and box.cfg options.
  • Auth parameter cookie_max_age is now configurable with GraphQL API. Also now it's stored in clusterwide config, so changing it on a single server will affect all others in cluster.
  • Detect that we run under systemd and switch to syslog logging from stderr. This allows to filter log messages by severity with journalctl
  • Redesign WebUI

Changed

  • The project renamed to cartridge. Use require('cartridge') instead of require('cluster'). All submodules are renamed too. (incompatible change)
  • Submodule cluster.test_helpers renamed to cartridge.test-helpers for consistency. (incompatible change)
  • Modifying auth params with GraphQL before the cluster was bootstrapped is now forbidden and returns an error.
  • Introducing a new auth parameter cookie_renew_age. When cluster handles an HTTP request with the cookie, whose age in older then specified, it refreshes the cookie. It may be useful to set cookie_max_age to a small value (for example 10 minutes), so the user will be logged out after cookie_max_age seconds of inactivity. Otherwise, if he's active, the cookie will be updated every cookie_renew_age seconds and the session will not be interrupted.
  • Changed configuration options for cluster.cfg(): roles now is a mandatory table, workdir is optional now (defaults to ".")
  • Parameter advertise_uri is optional now, default value is derived as follows. advertise_uri is a compound of <HOST> and <PORT>. When <HOST> isn't specified, it's detected as the only non-local IP address. If it can't be determined or there is more than one IP address available it defaults to "localhost". When <PORT> isn't specified, it's derived from numeric suffix _<N> of TARANTOOL_INSTANCE_NAME: <PORT> = 3300+<N>. Otherwise default <PORT> = 3301 is used.
  • Parameter http_port is derived from instance name too. If it can't be derived it defaults to 8081. New parameter http_enabled = false is used to disable it (by default it's enabled).
  • Removed user cluster, which was used internally for orchestration over netbox. Tarantool built-in user admin is used instead now. It can also be used for HTTP authentication to access WebUI. Cluster cookie is used as a password in both cases. (incompatible change)

Removed

Two-layer table structure in API, which was deprecated earlier, is now removed completely:

  • cartridge.service_registry.*
  • cartridge.confapplier.*
  • cartridge.admin.*

Instead you can use top-level functions:

  • cartridge.config_get_readonly
  • cartridge.config_get_deepcopy
  • cartridge.config_patch_clusterwide
  • cartridge.service_get
  • cartridge.admin_get_servers
  • cartridge.admin_get_replicasets
  • cartridge.admin_probe_server
  • cartridge.admin_join_server
  • cartridge.admin_edit_server
  • cartridge.admin_expel_server
  • cartridge.admin_enable_servers
  • cartridge.admin_disable_servers
  • cartridge.admin_edit_replicaset
  • cartridge.admin_get_failover
  • cartridge.admin_enable_failover
  • cartridge.admin_disable_failover

[0.10.0] - 2019-08-01

Added

  • Cluster can now operate without vshard roles (if you don't need sharding). Deprecation warning about implicit vshard roles isn't issued any more, they aren't registered unless explicitly specified either in cluster.cfg({roles=...}) or in dependencies to one of user-defined roles.
  • New role flag hidden = true. Hidden roles aren't listed in cluster.admin.get_replicasets().roles and therefore in WebUI. Hidden roles are supposed to be a dependency for another role, yet they still can be enabled with edit_replicaset function (both Lua and GraphQL).
  • New role flag: permanent = true. Permanent roles are always enabled. Also they are hidden implicitly.
  • New functions in cluster test_helpers - Cluster:upload_config(config) and Cluster:download_config()

Fixed

  • cluster.call_rpc used to return 'Role unavailable' error as a first argument instead of nil, err. It can appear when role is specified in clusterwide config, but wasn't initialized properly. There are two reasons for that: race condition, or prior error in either role init or apply_config methods.

[0.9.2] - 2019-07-12

Fixed

  • Update frontend-core dependency which used to litter package.loaded with tons of JS code

[0.9.1] - 2019-07-10

Added

  • Support for vshard groups in WebUI

Fixed

  • Uniform handling vshard group 'default' when multiple groups aren't configured
  • Requesting multiple vshard groups info before the cluster was bootstrapped

[0.9.0] - 2019-07-02

Added

  • User management page in WebUI
  • Configuring multiple isolated vshard groups in a single cluster
  • Support for joining multiple instances in a single call to config_patch_clusterwide
  • Integration tests helpers

Changed

  • GraphQL API known_roles format now includes roles dependencies
  • cluster.rpc_call option remote_only renamed to prefer_local with the opposite meaning

Fixed

  • Don't display renamed or removed roles in webui
  • Uploading config without a section removes it from clusterwide config

[0.8.0] - 2019-05-20

Added

  • Specifying role dependencies
  • Set read-only option for slave nodes
  • Labels for servers

Changed

  • Admin http endpoint changed from /graphql to /admin/api
  • Graphql output now contains null values for empty objects
  • Deprecate implicity of vshard roles 'cluster.roles.vshard-storage', 'cluster.roles.vshard-router'. Now they should be specified explicitly in cluster.cfg({roles = ...})
  • cluster.service_get('vshard-router') now returns cluster.roles.vshard-router module instead of vshard.router (incompatible change)
  • cluster.service_get('vshard-storage') now returns cluster.roles.vshard-storage module instead of vshard.storage` (incompatible change)
  • cluster.admin.bootstrap_vshard now can be called on any instance

Fixed

  • Operating vshard-storage roles before vshard was bootstrapped

[0.7.0] - 2019-04-05

Added

  • Failover priority configuration using WebUI
  • Remote calls across cluster instances using cluster.rpc module
  • Displaying box.cfg and box.info in WebUI
  • Authorization for HTTP API and WebUI
  • Configuration download/upload via WebUI
  • Lua API documentation, which you can read with tarantoolctl rocks doc cluster command.

Changed

  • Instance restart now triggers config validation before roles initialization
  • Update WebUI design
  • Lua API changed (old functions still work, but issue warnings): - cluster.confapplier.* -> cluster.config_* - cluster.service_registry.* -> cluster.service_*

[0.6.3] - 2019-02-08

Fixed

  • Cluster used to call 'validate()' role method instead of documented 'validate_config()', so it was added. The undocumented 'validate()' still may be used for the sake of compatibility, but issues a warning that it was deprecated.

[0.6.2] - 2019-02-07

Fixed

  • Minor internal corner cases

[0.6.1] - 2019-02-05

Fixed

  • UI/UX: Replace "bootstrap vshard" button with a noticable panel
  • UI/UX: Replace failover panel with a small button

[0.6.0] - 2019-01-30

Fixed

  • Ability to disable vshard-storage role when zero-weight rebalancing finishes
  • Active master indication during failover
  • Other minor improvements

Changed

  • New frontend core
  • Dependencies update
  • Call to join_server automatically does probe_server

Added

  • Servers filtering by roles, uri, alias in WebUI

[0.5.1] - 2018-12-12

Fixed

  • WebUI errors

[0.5.0] - 2018-12-11

Fixed

  • Graphql mutations order

Changed

  • Callbacks in user-defined roles are called with is_master parameter, indicating state of the instance
  • Combine cluster.init and cluster.register_role api calls in single cluster.cfg
  • Eliminate raising exceptions
  • Absorb http server in cluster.cfg

Added

  • Support of vshard replicaset weight parameter
  • join_server() timeout parameter to make call synchronous

[0.4.0] - 2018-11-27

Fixed/Improved

  • Uncaught exception in WebUI
  • Indicate when backend is unavailable
  • Sort servers in replicaset, put master first
  • Cluster mutations are now synchronous, except joining new servers

Added

  • Lua API for temporarily disabling servers
  • Lua API for implementing user-defined roles

[0.3] - 2018-10-30

Changed

  • Config structure incompatible with v0.2

Added

  • Explicit vshard master configuration
  • Automatic failover (switchable)
  • Unit tests

[0.2] - 2018-10-01

Changed

  • Allow vshard bootstrapping from ui
  • Several stability improvements

[0.1] - 2018-09-25

Added

  • Basic functionality
  • Integration tests
  • Luarock-based packaging
  • Gitlab CI integration