Atualizar versões do driver

Visão geral

Nesta seção, você pode identificar as alterações que deve fazer no seu aplicação para atualizar seu driver para uma nova versão.

Antes de atualizar, execute as seguintes ações:

• Certifique-se de que a nova versão do driver seja compatível com as versões do MongoDB Server às quais seu aplicação se conecta e com as versões Ruby em que seu aplicação é executado. Para visualizar informações de compatibilidade, consulte a página decompatibilidade do .

• Resolva quaisquer alterações significativas entre a versão atual do driver que seu aplicativo está usando e a versão de atualização planejada na seção Alterações significativas.

A partir da versão 2.18.0, o driver usa sinalizadores de recursos para gerenciar alterações significativas. Esse recurso permite que você opte por fazer alterações significativas antes do lançamento da próxima versão principal.

Controle de Versão

Cada versão de driver Ruby tem um número de versão no formato MAJOR.MINOR.PATCH. O driver Ruby usa Controle de Versão Semântica (SemVer), o que normalmente significa:

• Alterações significativas, habilitação de novas funcionalidades e remoção de funcionalidades obsoletas só serão feitas em versões principais.

• Novas funcionalidades serão adicionadas usando sinalizadores de recursos, que devem ser habilitados por meio de uma alteração de configuração de aceitação. Esses sinalizadores de recurso podem ser adicionados em versões principais ou secundárias.

• A funcionalidade pode ser marcada como obsoleta em versões principais ou secundárias, mas não será removida até a próxima versão principal, no mínimo.

• As versões de patch conterão apenas correções e atualizações de segurança não significativas.

Mudanças de última hora

Uma alteração interruptiva é uma modificação em uma convenção ou comportamento em uma versão específica do driver que pode impedir que seu aplicação funcione corretamente se você não a resolver antes de atualizar.

As alterações interruptivas nesta seção são categorizadas pela versão do driver que as introduziram. Ao atualizar as versões do driver, resolva todas as alterações interruptivas entre a versão atual e a atualizada.