• 
      

    Add Doc Converter to the sample docker-compose.yaml configurations.

    Review Request #14199 — Created Oct. 11, 2024 and submitted

    Information

    Review Board
    master

    Reviewers

    This updates our existing sample docker compose config files to show how to
    launch Review Board alongside an instance of Doc Converter, the document
    conversion service needed for Power Pack's document review feature.

    The configs now have an instruction step for dealing with "optional services",
    which are any services that we may include in the file but are optional. For
    now RabbitMQ and Doc Converter are the only optional services, but in the
    future we'll add Review Bot too.

    The instructions for the RabbitMQ service make it clear that it can be
    used with multiple services, not just Doc Converter, and lists the
    services that require it.

    Tested this sample docker-compose and successfully ran the containers. Was
    able to upload documents to the Review Board server and have them converted.

    Summary ID
    Add Doc Converter to the sample docker-compose.yaml configurations.
    This updates our existing sample docker compose config files to show how to launch Review Board alongside an instance of Doc Converter, the document conversion service needed for Power Pack's document review feature. The configs now have an instruction step for dealing with "optional services", which are any services that we may include in the file but are optional. For now RabbitMQ and Doc Converter are the only optional services, but in the future we'll add Review Bot too. The instructions for the RabbitMQ service make it clear that it can be used with multiple services, not just Doc Converter, and lists the services that require it.
    69550fca77792d8a0a61672adac533b1ab44fee2
    Description From Last Updated

    This should say docker-compose.docconverter.yaml. Can we also move it below the plain mysql and postgres ones?

    daviddavid

    It'll still be a long line, but can we add a newline before "[document review]"?

    daviddavid

    Can you move this down just above the BROKER_URL line, and indent to match?

    daviddavid

    We might a well list Review Bot.

    chipx86chipx86

    Blank line between these.

    chipx86chipx86

    Blank line between these.

    chipx86chipx86

    Blank line between these.

    chipx86chipx86
    david
    1. 
        
    2. contrib/docker/examples/README.md (Diff revision 1)
       
       
      Show all issues

      This should say docker-compose.docconverter.yaml. Can we also move it below the plain mysql and postgres ones?

    3. contrib/docker/examples/README.md (Diff revision 1)
       
       
      Show all issues

      It'll still be a long line, but can we add a newline before "[document review]"?

    4. contrib/docker/examples/docker-compose.docconverter.yaml (Diff revision 1)
       
       
       
       
       
       
      Show all issues

      Can you move this down just above the BROKER_URL line, and indent to match?

    5. 
        
    maubin
    david
    1. Ship It!
    2. 
        
    chipx86
    1. Thinking about this.. I think we should just move the services into the existing docker-compose files. We can have the documentation mention that these are optional services, explain what they're for. That way there's less for users to have to choose from when seeing the files ("Do I want MySQL, Postgres, or Doc Converter?"), less for us to maintain, and we help move to Doc Converter being a standard service.

      I'd love to eventually do the same for Review Bot.

      1. That's a good point, I'll go with this. I can even do Review Bot in a separate change.

    2. 
        
    maubin
    david
    1. Ship It!
    2. 
        
    chipx86
    1. Comments on the first file apply to the second as well.

    2. contrib/docker/examples/docker-compose.mysql.yaml (Diff revision 3)
       
       
       
       
       
       
      Show all issues

      We might a well list Review Bot.

      1. I do that and more in /r/14248/

    3. Show all issues

      Blank line between these.

    4. Show all issues

      Blank line between these.

    5. Show all issues

      Blank line between these.

    6. 
        
    maubin
    david
    1. Ship It!
    2. 
        
    chipx86
    1. Ship It!
    2. 
        
    maubin
    Review request changed
    Status:
    Completed
    Change Summary:
    Pushed to release-7.x (1084658)