Como usar services-config.yaml

Quando você usa o gerenciador de serviços simplificado do Linux para realizar uma migração, o Migrate to Containers cria um novo arquivo de artefato, services-config.yaml. Use esse arquivo para controlar a inicialização do aplicativo em um contêiner implantado.

Por exemplo, depois de migrar o contêiner, edite o arquivo services-config.yaml para controlar a inicialização do aplicativo e:

  • Remover aplicativos do arquivo
  • Adicionar aplicativos ao arquivo
  • Editar as propriedades de inicialização de um aplicativo

Veja abaixo um exemplo de arquivo services-config.yaml:

version: v1beta1
env:
  - name: KEY1
    value: VALUE1
  - name: KEY2
    value: VALUE2
applications:
    - name: nginx
      type: forking
      envfile: /path/to/file.txt
      env:
        - name: KEY3
          value: VALUE3
      start:
      - cmd: /usr/sbin/nginx -g 'daemon on; master_process on;'
      pidfile: /run/nginx.pid
    - name: ssh@
      type: simple
      start:
      - cmd: /usr/sbin/sshd -i $SSHD_OPTS
        ignore_errors: true
      runtime_directories:
        mode: "0755"
        paths:
          - /run/sshd
        preserve: true
    - name: suitecrm
      type: exec
      start:
      - cmd: /etc/init.d/suitecrm start
      status:
        cmd: /etc/init.d/suitecrm status
    - name: phpsessionclean
      type: oneshot
      start:
        - cmd: /usr/lib/php/sessionclean
      timers:
        - name: phpsessionclean.timer
          on_calendar:
            - cron: 09,39 * * * *
    - name: mariadb
      type: notify
      prestart:
        - cmd: /usr/bin/install -m 755 -o mysql -g root -d /var/run/mysqld
        - cmd: /bin/sh -c "systemctl unset-environment _WSREP_START_POSITION"
        - cmd: /bin/sh -c "[ ! -e /usr/bin/galera_recovery ] && VAR= || VAR=`cd /usr/bin/..; /usr/bin/galera_recovery`; [ $? -eq 0 ] && systemctl set-environment _WSREP_START_POSITION=$VAR || exit 1"
      start:
      - cmd: /usr/sbin/mysqld $MYSQLD_OPTS $_WSREP_NEW_CLUSTER $_WSREP_START_POSITION
      poststart:
        - cmd: /bin/sh -c "systemctl unset-environment _WSREP_START_POSITION"
        - cmd: /etc/mysql/debian-start
      user: mysql
      group: mysql

Neste arquivo:

  • env: especifica variáveis de ambiente no nível global ou no aplicativo. Se você especificar a mesma variável de ambiente nos níveis global e de aplicativo, a variável de ambiente no nível do aplicativo terá precedência.

    • Para variáveis de ambiente definidas no nível global, use env para especificar um par name/value. Os nomes podem conter letras ASCII, dígitos e o caractere sublinhado. Os nomes não podem começar com um dígito.

    • Para variáveis de ambiente definidas no nível do aplicativo, use env para especificar um par name/value. Ou use envfile para especificar o caminho para um arquivo de texto que contenha linhas no formulário:

      # Comments allowed
      KEY=VALUE

      Se o arquivo de texto contiver uma definição de variável de ambiente que duplique uma especificada por env, a especificada por env terá precedência.

  • applications: especifica a lista de aplicativos a serem iniciados quando você implanta o contêiner e define as propriedades de inicialização do aplicativo.

    • name: especifica o nome do aplicativo.

    • type especifica o tipo de aplicativo, como um dos seguintes:

      • forking: execute o arquivo especificado por start sem bifurcação. O executável do serviço deve ser bifurcado. Recomendamos que você também defina pidfile.

      • exec: faça a bifurcação para executar o serviço. O serviço é considerado iniciado depois que exec é chamado no executável.

      • simple - Igual a exec. Um serviço simple se comporta de maneira diferente da definição systemd porque aguarda fork e exec em vez de fork.

      • notify: igual a exec, exceto que para systemd a variável de ambiente NOTIFY_SOCKET não é definida, de modo que as chamadas sd_notify systemd não funcionam.

      • oneshot: o serviço é considerado iniciado depois que exec é chamado no executável. O status é error se o serviço sair com um código de erro diferente de 0.

    • Comandos prestart, start, poststart e status do serviço.

      Para iniciar um serviço, o Migrate to Containers executa os comandos prestart (se houver), o start e, finalmente, os comandos poststart (se houver). Se um comando falhar e você não tiver configurado o comando para usar ignore_errors, o serviço será interrompido e você verá uma mensagem de erro no status do serviço.

      Os comandos usados para executar operações específicas no aplicativo têm o formato:

        command-type: 
          cmd: command
          shell: /bin/sh
          ignore_errors: false
          ignore_environment_variables: false

      Em que:

      • command-type: especifica o tipo de comando como prestart, start, poststart ou status.

        Para start, é possível ter um único comando, a menos que type seja oneshot.

        Se type=forking ou type=oneshot, os comandos poststart serão executados após a bifurcação do comando start. Caso contrário, eles serão executados imediatamente após o comando start.

      • command: especifica o comando a ser executado para realizar a operação.

      • shell (Opcional): por padrão, todos os comandos são executados no shell /bin/sh. Opcionalmente, você pode definir shell como /bin/bash.

      • ignore_errors (opcional): se true, será registrado um código de saída do comando normalmente considerado uma falha, mas o comando será considerado bem-sucedido. O valor padrão é false.

        Por padrão, o Migrate to Containers define ignore_errors como true para qualquer executável systemd que inclua o prefixo "-".

      • ignore_environment_variables (Opcional): se true, a substituição da variável de ambiente não será aplicada. O valor padrão é false.

        Por padrão, o Migrate to Containers define ignore_environment_variables como true para qualquer executável systemd que inclua o prefixo ":".

    • pidfile: especifica o arquivo pid que contém o ID do processo do serviço usado para verificar se o processo ainda está em execução.

    • chdir: especifica o diretório de trabalho do processo iniciado.

    • user: especifica o nome de usuário com que o novo processo foi iniciado.

    • group: especifica o nome do grupo com que o novo processo foi iniciado.

    • timers: especifica a lista de timers do aplicativo. O aplicativo será ativado sempre que um dos timers especificados decorrer.

      version: v1beta1
      env: []
      Applications:
      - name: service_name
        type: service_type
        start:
          - cmd: service_exec_command
        timers:
          - name: timer_name
            on_calendar:
              - cron: realtime_time
            on_startup:
              - duration: monotonic_time
            on_service_start:
              - duration: monotonic_time
            on_service_stop:
              - duration: monotonic_time
      
      • name: especifica o nome do timer.

      • on_calendar: especifica a lista de eventos da agenda do timer.

        • cron: um horário especificado usando o formato cron. Exemplo:

          cron: 0 0 * * *
          cron: @daily
          
      • on_startup: especifica uma lista de durações (em relação à implantação do contêiner).

        • duration: um horário especificado usando o formato de duração. Exemplo:
        duration: 30m
        duration: 1sec
        
      • on_service_start: especifica uma lista de durações, em relação a quando o status do aplicativo muda para ativo.

        • duration: um horário especificado usando o formato de duração.
      • on_service_stop: especifica uma lista de durações, em relação a quando o status do aplicativo é muda para inativo.

        • duration: um horário especificado usando o formato de duração.
    • Use as seguintes propriedades para especificar paths para diretórios criados antes de iniciar o serviço:

      • runtime_directories: especifica a lista de paths para os diretórios criados em /run/.

      • state_directories: especifica a lista de paths para os diretórios criados em /var/lib/.

      • cache_directories: especifica a lista de paths para os diretórios criados em /var/cache/.

      • logs_directories: especifica a lista de paths para os diretórios criados em /var/log/.

      • configuration_directories: especifica a lista de paths para os diretórios criados em /etc/.

      Cada uma dessas propriedades tem as seguintes opções:

      • mode: especifica o modo de arquivo. O padrão é 0755, correspondente a acesso de leitura e execução para todos, e acesso de gravação para o proprietário.
      • preserve: se false o diretório for limpo quando o serviço for interrompido. O padrão é true.

Adicionar ou remover um serviço no arquivo services.yaml

É possível adicionar ou remover um serviço pelo arquivo services.yaml editando-o manualmente. Sempre que você adicionar um novo serviço, precisará preencher os seguintes campos:

  • name
  • type
  • start

Para mais informações sobre os campos obrigatórios e opcionais de um serviço, consulte a definição services.yaml acima.

Adicionar um serviço

Para adicionar um serviço ao arquivo services.yaml, siga estas etapas:

  1. Abra o arquivo services.yaml em um editor de texto para modificação.

  2. Em services.yaml, navegue até o atributo applications:

    version: v1beta1
    env:
     - name: KEY1
     ...
    applications:
    
  3. Adicione o serviço desejado na linha abaixo do atributo applications, começando com o campo name, seguido pelos outros campos obrigatórios e opcionais adequados ao aplicativo:

    version: v1beta1
    env:
     - name: KEY1
     ...
    applications:
    - name:
      type:
      start:
        - cmd:
      ...
    

    Se o arquivo services.yaml já tiver definições de serviço no atributo applications, adicione um novo serviço a partir do campo name na linha abaixo da última entrada do serviço anterior:

    version: v1beta1
    env:
     - name: KEY1
     ...
    applications:
    - name:
      type:
      start:
    - name:
      type:
      start:
        ...
    
  4. Salve o arquivo services.yaml.

Remover um serviço

Para remover um serviço do arquivo services.yaml, siga estas etapas:

  1. Abra o arquivo services.yaml em um editor de texto para modificação.

  2. Em services.yaml, navegue até o atributo applications:

    version: v1beta1
    env:
     - name: KEY1
     ...
    applications:
    ...
    
  3. Remova o serviço desejado começando com o campo name, seguido pelos outros campos obrigatórios e opcionais apropriados para o aplicativo. Exemplo:

    Antes de o serviço ser removido:

    version: v1beta1
    env:
    - name: KEY1
      ...
    applications:
    - name:
      type:
      start:
        - cmd:
    - name:
      ...
    
    

    Depois que o serviço for removido:

    version: v1beta1
    env:
    - name: KEY1
      ...
    applications:
    - name:
      ...
    
  4. Salve o arquivo services.yaml.