Artifakt Docs
Stacks 5.0 and up
Search
⌃K
Links

Migrate to Artifakt

We will assume that you already created your project and that your environment is in the started state.

Prepare your repository

  1. 1.
    Check all files in your repository
  2. 2.
    Configure your repository in your project
  3. 3.
    Configure your repository branch in your environment

Environment security

  1. 1.
    Create all of your needed IP groups
  2. 2.
    Apply your IP groups on SSH accesses
  3. 3.
    Apply your IP groups on HTTPS accesses
  4. 4.
    Activate your SSH accesses

External flows

  1. 1.
    Define all external flows your application will have (ex: Mangopay, Apple Pay...)
  2. 2.
    Contact the support team to set up the configuration needed for those external providers

Environment variables configuration

  1. 1.
    Define all variables you'll need to use (ex: themes, languages...)
  2. 2.
    Add all environment variables you'll need to use for your deployments

Database operations

  1. 1.
    Prepare your MySQL dump file from your original database
  2. 2.
    Upload your dump on the server
  3. 3.
    Remove all definers from the dump
  4. 4.
    Import your database
  5. 5.
    Configure all urls for your website (core_config_data)
Remove all definers with this command:
sed -i 's/DEFINER=[^]*/*/g' yourdump.sql Find all tables with links with this request:
select * from core_config_data where path like '%base%'; Connect to the Database using this command
mysql -u $ARTIFAKT_MYSQL_USER -h $ARTIFAKT_MYSQL_HOST -p$ARTIFAKT_MYSQL_PASSWORD $ARTIFAKT_MYSQL_DATABASE_NAME -A
Import your database mysql -u $ARTIFAKT_MYSQL_USER -h $ARTIFAKT_MYSQL_HOST -p$ARTIFAKT_MYSQL_PASSWORD $ARTIFAKT_MYSQL_DATABASE_NAME -A < /data/mydump.sql
Be careful when you upload your file to the server to check the disk space. We generally copy files to /tmp and move it to /mnt/shared/data to be available from the applicative container.
You can also use a MySQL client.

Elasticsearch configuration

  1. 1.
    Identify in your configurations in the core_config_data
  2. 2.
    Retrieve the Elasticsearch information from the console from the Resources tab
  3. 3.
    Configure your Database with the right URL you found in step 2

Media operations

  1. 1.
    Prepare your media package from your old servers
  2. 2.
    Upload all medias with rsync to /mnt/shared/data/pub/media
  3. 3.
    Set rights to 33:33 for all files
Once all files are copied, set rights on all medias:
chown 33:33 -R /mnt/shared/data/pub/media

Jobs validation

  1. 1.
    Run a build & deploy job
  2. 2.
    Check the build process to see if it completes with success
  3. 3.
    Check the deploy job to see if it completes with success
  4. 4.
    Create custom scripts like build.sh or entrypoint.sh if needed
  5. 5.
    Validate that your app works with the Artifakt-provided domains

Domains management

  1. 1.
    Define all domains you want to use
  2. 2.
    Register all domains in the console following every step (TXT and CNAME or IPs)
  3. 3.
    Add TXT and CNAME/IPs to your DNS to validate the custom domains
  4. 4.
    Check the propagation of the DNS records using a DNS checker
  5. 5.
    Validate that everything is working on your website
  6. 6.
    (Optional) Flush caches if needed